mcclowes/code-frontmatter
Context-efficient codebase navigation and documentation using structured frontmatter headers. Use this when exploring an unfamiliar codebase, answering "where is X / how does Y work" questions, or when asked to add/maintain file-level documentation. Index a tree's headers in one pass instead of reading every file, and generate or validate frontmatter with the bundled scripts. Reach for it whenever token budget matters while navigating code, even if the user does not say "frontmatter".
71
100%
Does it follow best practices?
Impact
52%
4.33xAverage score across 7 eval scenarios
Passed
No known issues
Code Frontmatter
Context-efficient codebase navigation and documentation using structured frontmatter headers. A short YAML header at the top of each file describes its purpose and related files, so you can map a tree from headers (~50 tokens each) instead of reading every file (~1500 tokens each).
Structure
SKILL.md- Main skill instructions: the authoring vs navigating modes and the common-case workflowSPECIFICATION.md- Full frontmatter schema referencescripts/frontmatter.py- Bundled script togenerate,index, and validate frontmatterpython-example.py- Example of a frontmatter header in Pythontypescript-example.ts- Example of a frontmatter header in TypeScriptevals/evals.json- Test prompts for verifying the skill triggers and behaves correctly
Usage
This skill is automatically discovered by Claude when relevant to the task.
- Workspace
- mcclowes
- Visibility
- Public
- Created
- Last updated
- Repository
- https://github.com/mcclowes/skills
- Publish Source
- CLI
- Badge
