Skip to content

docs(readme): sync Skill Families table to current shipped state#634

Merged
potiuk merged 2 commits into
apache:mainfrom
justinmclean:readme-skill-families-sync
Jun 29, 2026
Merged

docs(readme): sync Skill Families table to current shipped state#634
potiuk merged 2 commits into
apache:mainfrom
justinmclean:readme-skill-families-sync

Conversation

@justinmclean

Copy link
Copy Markdown
Member

Summary

Eight families now listed (up from five) with correct skill counts and proper mode labels:

  • setup: 6 → 8 skills
  • security: 9 → 12 skills; modes updated to "Triage, Drafting"
  • pr-management: 3 → 4 skills; family README linked
  • release-management: "Proposed, 10 skills proposed" now "Experimental, all 10 skills shipped"; modes updated to "Triage, Drafting"
  • mentoring: "1 skill" → 3 skills; description updated to reflect shipped set
  • issue: 5 → 8 skills; family README linked
  • contributor-growth: new row (5 skills, docs/contributor-growth/)
  • repo-health: new row (5 skills, docs/repo-health/)
  • utilities: 2 → 3 skills (optimize-skill added)

Intro paragraph updated: removed "four families / proposed release-management" framing; now says eight families all experimental or stable.

Generated-by: Claude (Opus 4.7)

Type of change

  • Skill change (.claude/skills/<name>/) — eval fixtures updated below
  • Tool / bridge contract (tools/<system>/*.md)
  • Python package (tools/*/ with pyproject.toml)
  • Groovy reference impl
  • Cross-cutting (RFC, AGENTS.md, sandbox, privacy-LLM)
  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Project template (projects/_template/)
  • CI / dev loop (prek, workflows, validators)
  • Other:

Test plan

  • prek run --all-files passes
  • For Python packages touched: uv run pytest / ruff check / mypy passes
  • For Groovy bridges touched: command-line invocation tested end-to-end
  • For skill changes: eval suite passes for the affected skill
    (PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/)
  • For skill behaviour changes: a new or updated eval fixture is included in this PR
    (a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)
  • Other:

Eight families now listed (up from five) with correct skill counts
and proper mode labels:

- setup: 6 → 8 skills
- security: 9 → 12 skills; modes updated to "Triage, Drafting"
- pr-management: 3 → 4 skills; family README linked
- release-management: "Proposed, 10 skills proposed" now "Experimental,
  all 10 skills shipped"; modes updated to "Triage, Drafting"
- mentoring: "1 skill" → 3 skills; description updated to reflect shipped set
- issue: 5 → 8 skills; family README linked
- contributor-growth: new row (5 skills, docs/contributor-growth/)
- repo-health: new row (5 skills, docs/repo-health/)
- utilities: 2 → 3 skills (optimize-skill added)

Intro paragraph updated: removed "four families / proposed
release-management" framing; now says eight families all
experimental or stable.

Generated-by: Claude (Opus 4.7)
@justinmclean justinmclean self-assigned this Jun 29, 2026
@potiuk potiuk merged commit 27d3252 into apache:main Jun 29, 2026
28 checks passed
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.

2 participants