Skip to content

Catalogue the Incubator skills and check curated sources weekly - #2040

Draft
potiuk wants to merge 2 commits into
apache:mainfrom
potiuk:incubator-skill-sources
Draft

potiuk wants to merge 2 commits into
apache:mainfrom
potiuk:incubator-skill-sources

Conversation

@potiuk

@potiuk potiuk commented Nov 9, 2026

Copy link
Copy Markdown
Member

The ASF organization curated apache/incubator as a skill source for releasecheck only, while the Incubator now ships eleven skills in tools/skills/ — most recently the graduation self-assessment announced on general@. Nothing here noticed, and nothing would notice the next one.

Catalogue — organizations/ASF/skill-sources.md now lists every skill the Incubator ships, with:

  • whether Magpie can install it: pinned, untagged (a directory, no tag yet), single-file (a lone .md, which neither Magpie nor a marketplace can install), or draft;
  • which agent marketplaces offer it (claude-code, codex, copilot).

It also explains the two install paths — through Magpie for any agent, or from the Incubator's own per-agent catalogs — and that the Incubator versions per skill (<skill>-<version> tags), so each skill is curated as its own descriptor pinned to its own tag. docs/skill-sources/registry.md points at the catalogue.

Weekly drift check — tools/dev/check-skill-source-drift.py compares every curated catalogue and pin with its GitHub source: new, removed or re-laid-out skills, first or newer tags, a pinned tag that moved, and changes in any of the three marketplace catalogs. skill-source-drift.yml runs it every Monday and keeps one issue open while there is drift, closing it once back in sync. It never edits a pin: a moved tag is a reason to look, not to re-pin. Descriptors that share a repository share one catalogue. Against apache/incubator today it reports in sync, and the releasecheck-0.5.1 pin still resolves to the recorded commit.

Related — a companion PR to apache/incubator moves the single-file skills into directories and lists all of them in the Claude Code, Codex and Copilot catalogs; once its skills are tagged, this check flags each one for pinning. A follow-up here will tell adopters when a curated pin moves.

Testing — 16 unit tests with a fake GitHub API; live run against apache/incubator; prek clean.


Was generative AI tooling used to co-author this PR?
  • Yes — Claude Code (Claude Opus 5)

Generated-by: Claude Code (Claude Opus 5) following the guidelines

🤖 Generated with Claude Code

The ASF organization curated apache/incubator for releasecheck only,
while the Incubator now ships eleven skills (graduation self-assessment,
maturity model, retirement, report review, and more). Nothing noticed.

organizations/ASF/skill-sources.md now lists every skill the Incubator
ships, whether Magpie can install it (pinned, untagged, single-file,
draft) and which agent marketplaces offer it, and explains the two
install paths: through Magpie for any agent, or from the Incubator's own
Claude Code, Codex and Copilot catalogs. Skills are versioned per skill,
so each one is curated as its own descriptor pinned to its own tag.

tools/dev/check-skill-source-drift.py compares every curated catalogue
and pin with its GitHub source: new, removed or re-laid-out skills,
first or newer tags, moved tags, and marketplace catalog changes. The
weekly skill-source-drift workflow runs it and keeps one issue open
while there is drift.

Generated-by: Claude Opus 5
@github-actions github-actions Bot added family:tools tools/* family:docs Docs, MISSION.md, READMEs family:ci .github workflows, prek, validators substrate:framework-dev Tool substrate: build / validate / eval the framework itself labels Nov 9, 2026
Codex lists a plugin skill only from skills/<name>/SKILL.md, so the
Incubator skills move into that layout. Treat such a plugin directory as
a directory skill, and scan from the shared root when a per-skill
descriptor points skills_root inside its plugin.

Generated-by: Claude Opus 5
@potiuk

potiuk commented Nov 9, 2026

Copy link
Copy Markdown
Member Author

Waits for apache/incubator#159

@potiuk
potiuk marked this pull request as draft November 9, 2026 09:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

family:ci .github workflows, prek, validators family:docs Docs, MISSION.md, READMEs family:tools tools/* substrate:framework-dev Tool substrate: build / validate / eval the framework itself

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant