refactor(skills): fold 11 language/shell/k8s husk skills into umbrella references (M2) - #897
Merged
Conversation
…a references Folds husks whose content already lives in the umbrella they point at: - kotlin-coroutines (0.93), kotlin-testing (0.97) -> engineering/kotlin/references/ - swift-concurrency (0.87), swift-testing (0.96) -> engineering/swift/references/ - php-quality, php-testing -> engineering/php/references/ - fish-shell-config (0.87), zsh-shell-config (0.91) -> infrastructure/shell-config/references/ - kubernetes-debugging, kubernetes-security -> infrastructure/kubernetes/references/ - cobalt-core (promoted_to: kubernetes) -> infrastructure/kubernetes/references/cobalt-*.md Every husk reference file was verified byte-identical (difflib ratio 1.000) against its umbrella counterpart before removal. Where the husk SKILL.md body held unique guidance not yet in the umbrella (php-quality, php-testing, fish, zsh), that content was merged into the umbrella reference first; the umbrella index files are condensed rewrites, which is why SKILL.md-level ratios are lower than the reference-level ones. Umbrellas are unchanged in scope - the kubernetes references retain the private infra knowledge. Inbound references updated across docs, hooks/README, migration scripts, and shell-config routing tables. Skills: 131 -> 120.
Skill-eval coverageChanged skills in this PR: 6 ( Report only. CI cannot run evals (the runner needs the Mapped
Uncoveredno eval coverage for changed skill(s): |
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
1 participant
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.
What
Folds 11 husk skills into the umbrella skills that already carry their content. This is a merge, not a removal — every umbrella stays, and no capability is dropped.
engineering/kotlin/references/engineering/kotlin/references/engineering/swift/references/engineering/swift/references/engineering/php/references/engineering/php/references/infrastructure/shell-config/references/infrastructure/shell-config/references/infrastructure/kubernetes/references/infrastructure/kubernetes/references/infrastructure/kubernetes/references/cobalt-*.mdVerification
Every husk
references/*.mdfile was compared withdifflib.SequenceMatcheragainst its umbrella counterpart before removal:
The three k8s-cluster husks score low at the
SKILL.mdlevel only because theumbrella's same-named reference is a condensed rewrite of the husk body
(the point of the exercise), while the deep content is preserved verbatim.
Inbound references
Swept all 11 names across agents, skills, hooks, scripts, docs, commands. Updated:
hooks/README.md,docs/*,README.md,scripts/fix-skill-paths.py,scripts/migrate-skills-to-folders.py, shell-config + kubernetes routing tables,and the two
fish-shell-configFORCE-ROUTE examples inskills/meta/do/SKILL.md(2-line rename only — no other part of that file is touched).
Skills: 131 -> 120.
validate-doc-counts.pyagrees.Gates
ruff check/ruff format --check(0.15.12) — passpytest scripts/tests/— 4700 passed, 1 skipped, 149 xfailedvalidate-skill-frontmatter.py— 120 OKvalidate-index-integrity.py— 0 errors, VERDICT PASSvalidate-doc-counts.py— all count claims agree