Proposal
Add a Sourcey-generated, searchable reference for 24 governed Runx skills under docs/sourcey-catalog/.
This would complement the existing curated catalog and operator index rather than replace them: the current pages remain the concise discovery layer, while the generated catalog exposes the full skill contracts with search, navigation, context exports, and immutable links back to each authoritative SKILL.md.
Current prototype
- Source ecosystem: Runx governed automation and MCP agent tooling
- Generator: Sourcey 3.6.5
- Source snapshot:
5afc25a83edf1c1320df7ac0d78c36f1523b5677
- Coverage: 24 skill pages across five operator-oriented groups
- Static output: 57 files, 3,153,984 content bytes
- HTML output: 26 pages (24 skills, one introduction, one root index)
- Search index: 202 records, including all 25 content pages
- Context exports:
llms.txt and llms-full.txt
The extractor reads each selected SKILL.md through the GitHub Contents API at the pinned commit, validates strict base64, verifies the returned Git blob SHA, computes a separate SHA-256 digest, and emits deterministic Markdown with an immutable source link. Sourcey then builds relative-link static output suitable for an upstream-owned durable home.
Proposed contribution
A docs-only PR containing:
- the 24-entry manifest and deterministic extractor;
- generated Markdown sources with immutable provenance links;
- Sourcey configuration and pinned build wrapper;
- the generated static site;
- structural verification for page, navigation, search, local-link, context-export, and credential-leak coverage;
- a maintainer-facing report of concrete documentation gaps measured from the selected sources.
Focused extractor tests currently pass 22/22. Build tests pass 4/4, and a clean Sourcey 3.6.5 build reproduces the output above. The final PR will include the structural verification result and exact commands.
If this layout is acceptable, I will open the prepared docs-only PR. The generated site can remain versioned under the repository so the durable source and output are both controlled by runxhq.
Proposal
Add a Sourcey-generated, searchable reference for 24 governed Runx skills under
docs/sourcey-catalog/.This would complement the existing curated catalog and operator index rather than replace them: the current pages remain the concise discovery layer, while the generated catalog exposes the full skill contracts with search, navigation, context exports, and immutable links back to each authoritative
SKILL.md.Current prototype
5afc25a83edf1c1320df7ac0d78c36f1523b5677llms.txtandllms-full.txtThe extractor reads each selected
SKILL.mdthrough the GitHub Contents API at the pinned commit, validates strict base64, verifies the returned Git blob SHA, computes a separate SHA-256 digest, and emits deterministic Markdown with an immutable source link. Sourcey then builds relative-link static output suitable for an upstream-owned durable home.Proposed contribution
A docs-only PR containing:
Focused extractor tests currently pass 22/22. Build tests pass 4/4, and a clean Sourcey 3.6.5 build reproduces the output above. The final PR will include the structural verification result and exact commands.
If this layout is acceptable, I will open the prepared docs-only PR. The generated site can remain versioned under the repository so the durable source and output are both controlled by
runxhq.