Document the skill system: taxonomy, meta-skill, case study, index - #2
Merged
Merged
Conversation
Makes the skill/knowledge system legible to a public visitor and self-propagating: - knowledge/notes/skill-vs-note-vs-code.md: the decision rule for what becomes a skill vs. a knowledge note vs. tested code, with boundary cases and rejected alternatives. - .claude/skills/write-skill/SKILL.md: a meta-skill that scaffolds new skills in the house style (frontmatter + Steps + Do not), then registers and logs them. - knowledge/notes/case-study-github-project-tracking.md: a worked, real example of the github-* skills end to end — the run they were generalized from. - README.md: a Skills index table + links to the taxonomy note and case study. - CLAUDE.md / LOG.md: register write-skill and log the change. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This was referenced Jul 27, 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
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.
Stacked on #1 (base is
add-github-skills). GitHub will auto-retarget this tomainonce #1 merges. Makes the skill/knowledge system legible to a public visitor and self-propagating.Added
knowledge/notes/skill-vs-note-vs-code.md— the decision rule for what becomes a skill vs. a knowledge note vs. tested code, with boundary cases and the alternatives that were rejected. The meta-decision behind how this repo is organized..claude/skills/write-skill/SKILL.md— a meta-skill that scaffolds new skills in the house style (frontmatter +## Steps+## Do not), then registers and logs them. Tools that build tools — the repo grows its own skills.knowledge/notes/case-study-github-project-tracking.md— a real, end-to-end run of thegithub-*skills (the one they were generalized from): scope split, the 404-means-wrong-account lesson, eventual-consistency verification.Changed
README.md— a## Skillsindex table linking every skill, plus pointers to the taxonomy note and case study.CLAUDE.md/LOG.md— registerwrite-skilland log the change.Together with #1, this turns "here are some skills" into a legible, self-documenting system — which is the part worth showing publicly.
🤖 Generated with Claude Code