Skip to content

Generated skills index: human view of the flat library - #25

Merged
mathias-heide merged 1 commit into
mainfrom
feat/skills-index
Sep 11, 2026
Merged

mathias-heide merged 1 commit into
mainfrom
feat/skills-index

Conversation

@mathias-heide

Copy link
Copy Markdown
Contributor

Summary

The flat library/skills/ layout is right for agents (DECISIONS.md D3) but unreadable for people. This adds the human view without changing the layout:

  • library/skills/README.md is generated by npm run generate:registry from each skill's facets.domains: one section per primary domain (first listed), one line per skill with status, ★ for recommended, the resource summary, and the secondary domains. Applied and drift-checked exactly like the agent manifests (new DOC_TARGETS in targets.ts).
  • skills-registry.json entries carry domains; summer skills list --by-domain prints the same grouping in the terminal.
  • docs/SKILLS.md and the README point at both.

Test plan

  • npx vitest run (1480 tests incl. new index-shape test), npm run generate:registry -- --check, npm run validate:library, npm run build
  • summer skills list --by-domain output checked by hand

🤖 Generated with Claude Code

library/skills/README.md is now rendered by the registry compiler from
each skill's facets.domains: one section per primary domain (the first
listed), one line per skill with status, recommended mark, summary and
secondary domains. Applied and drift-checked like the manifests (new
DOC_TARGETS in targets.ts). skills-registry.json carries domains and
`summer skills list --by-domain` prints the same grouping in the terminal.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@mathias-heide
mathias-heide merged commit 1ab6860 into main Sep 11, 2026
1 check passed
@mathias-heide
mathias-heide deleted the feat/skills-index branch September 11, 2026 17:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant