From 55b6991716943d967fb3c2b6e63e3098c8d7809a Mon Sep 17 00:00:00 2001 From: Justin McLean Date: Mon, 29 Jun 2026 01:41:43 +1000 Subject: [PATCH] docs(readme): sync Skill Families table to current shipped state MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- README.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 2bca92a9..cc16096a 100644 --- a/README.md +++ b/README.md @@ -156,11 +156,9 @@ for the full flow. ## Skill families -Four skill families ship in the framework (plus one experimental -family, mentoring; one proposed family, release-management; and -two meta utilities). Pick whichever families the adopter wants to -use; symlinks for the picked families land in the adopter's skill -directory. +Eight skill families ship in the framework, all at `experimental` or +`stable`. Pick whichever families the adopter wants to use; symlinks for +the picked families land in the adopter's skill directory. The **Modes** column maps each family to the MISSION agent-assistance taxonomy — see [`docs/modes.md`](docs/modes.md) for what each mode @@ -168,13 +166,15 @@ means and which modes are still proposed vs. shipping today. | Family | Modes | Purpose | Detail | |---|---|---|---| -| [**setup**](docs/setup/README.md) | (infra) | Isolated agent setup, framework adoption + maintenance, shared-config sync. The prerequisite — at minimum the `setup` skill itself runs out of this family. | 6 skills, [`docs/setup/`](docs/setup/) | -| [**security**](docs/security/README.md) | A, C | 16-step security-issue handling lifecycle — from `security@` import through CVE publication, including state sync. Maintainer-only. | 9 skills, [`docs/security/`](docs/security/) | -| **pr-management** | A | Maintainer-facing PR-queue management — triage, stats, and deep code review. | 3 skills, [`docs/pr-management/`](docs/pr-management/README.md) | -| [**release-management**](docs/release-management/README.md) | A, C | 14-step ASF release lifecycle, planning issue, RC cut + sign, `[VOTE]` thread, tally, promote, `[ANNOUNCE]`, archive, audit log. Agent never holds the RM's signing key and never publishes the release. **Proposed**, spec-first, like Mentoring; skill code lands in follow-up PRs. | 10 skills proposed, [`docs/release-management/`](docs/release-management/) | -| [**mentoring**](docs/mentoring/README.md) | Mentoring | Contributor mentoring — spec and tone guide in place; first skill (`pr-management-mentor`) shipping. **Experimental** — shape may change as adopter pilots and contributor-sentiment evaluation land. | 1 skill, [`docs/mentoring/`](docs/mentoring/README.md) | -| **issue** | A, Triage | Issue lifecycle management — triage, bug reproduction, fix drafting, and backlog re-assessment against the current branch. | 5 skills | -| **utilities** | (meta) | Framework meta-skills: author or update skills (`write-skill`); print a live index of all available skills (`list-skills`). | 2 skills | +| [**setup**](docs/setup/README.md) | (infra) | Isolated agent setup, framework adoption + maintenance, shared-config sync. The prerequisite — at minimum the `setup` skill itself runs out of this family. | 8 skills, [`docs/setup/`](docs/setup/) | +| [**security**](docs/security/README.md) | Triage, Drafting | 16-step security-issue handling lifecycle — from `security@` import through CVE publication, including state sync. Maintainer-only. | 12 skills, [`docs/security/`](docs/security/) | +| [**pr-management**](docs/pr-management/README.md) | Triage | Maintainer-facing PR-queue management — triage, stats, deep code review, and express-lane merge surfacing. | 4 skills, [`docs/pr-management/`](docs/pr-management/README.md) | +| [**release-management**](docs/release-management/README.md) | Triage, Drafting | 14-step ASF release lifecycle, planning issue, RC cut + sign, `[VOTE]` thread, tally, promote, `[ANNOUNCE]`, archive, audit log. Agent never holds the RM's signing key and never publishes the release. **Experimental**, all 10 skills shipped. | 10 skills, [`docs/release-management/`](docs/release-management/) | +| [**mentoring**](docs/mentoring/README.md) | Mentoring | Contributor mentoring — first-contact welcome, teaching-register PR/issue comments, and net-new good-first-issue authoring. **Experimental** — shape may change as adopter pilots and contributor-sentiment evaluation land. | 3 skills, [`docs/mentoring/`](docs/mentoring/README.md) | +| [**issue**](docs/issue-management/README.md) | Triage, Drafting | General-issue lifecycle: triage, reproduction, fix drafting, stale-sweep, deduplication, and backlog reporting. | 8 skills, [`docs/issue-management/`](docs/issue-management/README.md) | +| [**contributor-growth**](docs/contributor-growth/README.md) | Triage, Mentoring | Skills spanning the contributor-to-committer path: first-contact welcome, on-ramp issue authoring, activity tracking, nomination brief, post-vote onboarding. | 5 skills, [`docs/contributor-growth/`](docs/contributor-growth/README.md) | +| [**repo-health**](docs/repo-health/README.md) | Triage | Read-only repository-health audits: obsolete runner labels, Actions workflow security, dependency vulnerabilities, license/NOTICE compliance, flaky-test patterns. | 5 skills, [`docs/repo-health/`](docs/repo-health/README.md) | +| **utilities** | (meta) | Framework meta-skills: author or update skills (`write-skill`), restructure existing skills (`optimize-skill`), print a live index of all available skills (`list-skills`). | 3 skills | ## Maintenance