diff --git a/CLAUDE.md b/CLAUDE.md
index 8a79810..fb940f0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -6,6 +6,10 @@ This repo is a marketplace, not a single project. Each plugin under `plugins/` i
 
 Use gitmoji prefixes. The full convention — including the custom `🤖` for agent-file changes and the `🦇 BATMAN` initial-commit rule — lives in [`docs/workpad/specs/commit-conventions.md`](./docs/workpad/specs/commit-conventions.md). Read it before committing.
 
-## Workpad
+## Development: Use g4b_ai skills
+
+See `plugins/g4b_ai/skills` subdirectory and use those skills in this repository when developing.
+
+## Concepting: Workpad
 
 Working documents (plans, research, goals, designs, reports) live in `docs/workpad/`. The `workpad` skill in `plugins/g4b_ai/skills/workpad/` is authoritative for placement and naming.
diff --git a/README.md b/README.md
index 6b45e80..6cc593c 100644
--- a/README.md
+++ b/README.md
@@ -69,11 +69,8 @@ reliquary/
 ├── .claude-plugin/
 │   └── marketplace.json          # the marketplace listing
 ├── plugins/
-│   └── g4b_ai/
-│       ├── .claude-plugin/plugin.json
-│       ├── skills/
-│       └── README.md
-└── docs/                         # workpad: notes, research, goals, plans
+│   └── ...                       # e.g. g4b_ai's workpad: notes, research, goals, plans, ...
+└── docs/
 ```
 
 ## Conventions
diff --git a/plugins/g4b_ai/CLAUDE.md b/plugins/g4b_ai/CLAUDE.md
index e807e7e..2b1be85 100644
--- a/plugins/g4b_ai/CLAUDE.md
+++ b/plugins/g4b_ai/CLAUDE.md
@@ -1,2 +1 @@
-when committing, use gitmjoi prefixes instead of "chore" etc.
-
+These are workflow skills for the user. Most of them build on the concept of a workpad
diff --git a/plugins/g4b_ai/README.md b/plugins/g4b_ai/README.md
index 5c9f15e..ec8dc4a 100644
--- a/plugins/g4b_ai/README.md
+++ b/plugins/g4b_ai/README.md
@@ -87,16 +87,3 @@ ln -s /tmp/reliquary/plugins/g4b_ai/skills/workpad ~/.claude/skills/workpad
 ```
 
 A skill is just a directory containing a `SKILL.md` — no further wiring is needed.
-
-## Layout
-
-```
-plugins/g4b_ai/
-├── .claude-plugin/
-│   └── plugin.json
-└── skills/
-    ├── workpad/SKILL.md
-    ├── research-tree/SKILL.md
-    ├── implementation-orchestration/SKILL.md
-    └── markdown-embedded-svg/SKILL.md
-```