choo121600 opened a new pull request, #164:
URL: https://github.com/apache/airflow-steward/pull/164
## Why
The repo currently exposes 21 skills, but lacks a quick human-facing
way to discover them.
Skill routing already relies on the live frontmatter `description`
fields internally, but humans had no equivalent overview.
## What
Adds a new `list-skills` skill. On `/list-skills`, it runs a small
Python script which:
- walks `.claude/skills/*/SKILL.md`,
- parses frontmatter for `name` and `description`,
- groups skills by family prefix (with `pr-management` registered as
a two-token family in `KNOWN_TWO_TOKEN_FAMILIES`),
- prints each skill with the first sentence of its description.
The output is regenerated from the live filesystem on every run, so
there is no separate index to maintain.
## Scope
- Read-only on `.claude/skills/`.
- No external content reads, state mutation, or security-checklist
patterns triggered.
- `tools/skill-validator` passes (`OK (no violations)`).
- One new dir: `.claude/skills/list-skills/` (SKILL.md + script).
No changes elsewhere.
## Test plan
- [x] `python3 .claude/skills/list-skills/scripts/list_skills.py`
→ all 21 current skills listed under 5 families.
- [x] `--verbose` flag produces the alternate two-line layout.
- [x] `uv run --directory tools/skill-validator skill-validate`
→ no violations.
<img width="1025" height="1221" alt="image"
src="https://github.com/user-attachments/assets/ed30e4c8-e8b5-4285-a187-78cd860eecf4";
/>
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
