Generated skills index: human view of the flat library

README.md

@@ -336,7 +336,7 @@ matchmaking are not promised by this package.
 | `summer list templates` / `projects` | Browse. |
 | `summer events [--follow] [--kinds <csv>] [--since <seq>] [--json]` | The engine events channel (engine 0.5.66+): newest events, or stream them live. |
 | `summer debug [issue…]` | Support-ready Markdown debug report. |
-| `summer skills list` | Show all skills. |
+| `summer skills list` | Show all skills (`--by-domain` groups them; the same grouping is in [`library/skills/README.md`](library/skills/README.md)). |
 | `summer skills install <name>` | Install one. |
 | `summer skills install --all --agent <agent>` / `--recommended` [`--stable-only`] | Install every skill (preview included and labelled), or only the recommended subset; `--stable-only` skips preview skills. |
 | `summer tool <name> --args '<json>'` | Run any Summer tool from the shell — the same implementation the MCP tool uses. `summer tool --list` prints them all. |

docs/SKILLS.md

@@ -55,8 +55,13 @@ Supported agents: `summer`, `claude-code`, `codex`, `cursor`, `windsurf`, `antig
 ## Registry
 
 One source of truth: `library/skills/<slug>/` (`resource.yaml` + `SKILL.md`).
+The folder is flat by design (categories are `facets.domains`, see
+`docs/design/DECISIONS.md` D3); the human view is the generated
+[`library/skills/README.md`](../library/skills/README.md), one section per
+primary domain, and `summer skills list --by-domain` in the terminal.
 Everything else is compiled from it by `npm run generate:registry`:
 
+- `library/skills/README.md`: the browsable index above (`skills-index.md`).
 - `registry/generated/skills-registry.json`: what `summer skills list/install`
   and `summer setup` read (all agents, plugin and non-plugin).
 - `.claude-plugin/plugin.json` `skills:` (plus the `.codex-plugin/`,