list-steward-skills
Print a human-readable index of the skills in this repository.
The index is generated on every run from the live
.claude/skills/*/SKILL.md files — there is no cached copy to
keep in sync. The skill exists for humans (newcomers reading the
repo, maintainers checking what is available); agents route
invocations via the same frontmatter the script reads, so this
skill is purely informational.
Prerequisites
- Python 3.9+ on
PATHwithPyYAMLimportable. The framework's Python toolchain already meets this; no extra setup.
Step 1 — Run the listing script
Run the bundled script and present its output to the user verbatim:
python3 .claude/skills/list-steward-skills/scripts/list_skills.py
For a layout that puts each description on its own indented line
(easier to read when descriptions are long), pass --verbose:
python3 .claude/skills/list-steward-skills/scripts/list_skills.py --verbose
The script:
- walks
.claude/skills/*/SKILL.mdrelative to its own location; - parses each skill's YAML frontmatter for
name+description; - groups skills by family prefix (the first hyphen-separated
token, with
pr-managementrecognised as a two-token family — seeKNOWN_TWO_TOKEN_FAMILIES); - prints each skill with the first sentence of its description.
When a new multi-token family appears (e.g. a hypothetical
docs-build-*), add the prefix to KNOWN_TWO_TOKEN_FAMILIES in
scripts/list_skills.py; otherwise the
new skills land under the single-token head.
Step 2 — Hand the output to the user
Quote the script output back to the user as-is. Do not
paraphrase, summarise, or re-order — the value of this skill is
that the listing is the canonical, deterministic view of what
exists. If the user asks for more detail on a specific skill,
read that skill's SKILL.md and answer from it.
Hard rules
- Read-only. This skill never edits, creates, or deletes
files. It only reads
SKILL.mdfiles under.claude/skills/. - No paraphrasing. Always present the script output verbatim. Paraphrasing reintroduces the staleness this skill exists to prevent.
References
scripts/list_skills.py— the listing script Step 1 invokes.AGENTS.md— the framework's "Reusable skills" section, which explains the.claude/skills/layout and frontmatter convention.write-skill— sibling skill for authoring a new skill. Use it when the listing reveals a gap that warrants a new entry.