New skills#492
Merged
Merged
Conversation
New cross-cutting spec release-management-lifecycle.md (proposed, Drafting) grounds the 14-step, 10-skill family already designed in docs/release-management/ but absent from the loop specs; wired into the README and overview indexes. Record Known gaps in the existing specs for the plan pass to pick up: - mentoring-mode: family is one skill deep; first-contribution welcome and contributor-to-committer path tracker undesigned. - triage-mode: missing general-issue dedupe/stale/backlog-dashboard; contributor-growth skills not a formalised family (PMC nomination, emeritus, offboarding missing); repo-health audits a one-off. - meta-and-quality-tooling: add optimize-skill; triage-mode: add pr-management-quick-merge to Where it lives.
New cross-cutting spec project-agnosticism.md (experimental, infra) captures the standing audit + mechanism for keeping skills usable outside the ASF. Three generalisation mechanisms in preference order: placeholders for values, adapters for system swaps, and capability/backend flags for workflow branches that differ by ecosystem (the model already proven in docs/release-management/). ASF stays the default profile, never the only one. Known gaps for the plan pass: no automated ASF-coupling lint, no non-ASF adopter profile fixture/eval, and capability-flag vocabulary owed to contributor intake (ICLA vs DCO), security intake, and CVE allocation. Wired into the README/overview indexes and cross-referenced from adapters.md.
Plan pass under-covered the project-agnosticism spec. Add the two buildable gaps as work items: ASF-coupling advisory lint folded into skill-and-tool-validator (item 5) and a non-ASF adopter profile fixture plus smoke eval (item 7). Reword the deferral note so only the capability-flag vocabulary stays deferred (spec-authoring task following the release-management backend-flag precedent), and add explicit sequencing notes for the dedupe/backlog and repo-health gaps so later plan passes do not silently drop them. Refresh the stale What's-been-built spec list.
Member
Author
Correctness[advisory] release-management-lifecycle.md:8 — mode: Drafting but the spec text calls it "a family spanning Triage and Drafting". Single-value mode can't express both; add a note or extend the spec format. Conventions[advisory] IMPLEMENTATION_PLAN.md has no SPDX header (pre-existing; #474 will catch it). Both new spec files have correct headers. Securityno findings. |
potiuk
approved these changes
Jun 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
What
Spec-only changes that close the gap between the documented skill
catalogue and
tools/spec-loop/specs/, then refresh the implementationplan off the new gaps. No skill or tool code changes; nothing runtime.
New specs
release-management-lifecycle.md(proposed, Drafting). The 14-step,10-skill release family was fully designed in
docs/release-management/but absent from the loop specs, so the build loop couldn't see it. This
brings it in, mirroring
security-issue-lifecycle.md, with the twonon-negotiable boundaries recorded: the agent never holds the signing
key and never publishes the release.
project-agnosticism.md(experimental, infra). Captures thestanding de-ASF-coupling audit and the mechanism for keeping skills
usable outside the ASF: placeholders for values, adapters for system
swaps, and capability/backend flags for workflow branches that differ
by ecosystem (the model already proven in release-management). ASF stays
the default profile.
Recorded gaps (Known gaps for the plan pass to pick up)
mentoring-mode.md: family is one skill deep; first-contributionwelcome and contributor-to-committer path tracker undesigned.
triage-mode.md: missing general-issue dedupe / stale-handling /backlog dashboard; contributor-growth skills not a formalised family
(PMC nomination, emeritus, offboarding); repo-health audits a one-off
around
ci-runner-audit. Also addspr-management-quick-mergetoWhere it lives.
meta-and-quality-tooling.md: add the missingoptimize-skill.adapters.md: cross-reference to the new project-agnosticism spec.Plan refresh (
IMPLEMENTATION_PLAN.md)Reconciled against the new specs. Seven prioritised work items: two
standalone release-management skills (
release-vote-draft,release-announce-draft),issue-stale-sweep,mentoring-welcome, anASF-coupling advisory lint folded into
skill-and-tool-validator, adrafting-spec sync, and a non-ASF adopter profile fixture. Deferrals are
noted explicitly (capability-flag vocabulary, dedupe/backlog sequencing,
repo-health family) so later plan passes don't silently drop them.
Why
The catalogue had grown past what the specs described, so the loop's plan
pass was working from an incomplete picture. These specs make the gaps
visible and turn them into ordered, buildable work.
Type of change
.claude/skills/<name>/) — eval fixtures updated belowtools/<system>/*.md)tools/*/withpyproject.toml)docs/,README.md,CONTRIBUTING.md)projects/_template/)prek, workflows, validators)Test plan
prek run --all-filespassesuv run pytest/ruff check/mypypasses(
PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/)(a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)