Install any skill in seconds. Free to start, no credit card required.
Get Started Free →majiayu000/agent-documenting-references
Standardized reference documentation section structure for agents - project guidance, conventions, related agents, and Skills.
Passed 18 of 20 test cases with the skill, and 7 of 20 without it.
and 17 more in the full report
12 fixed8 passed either way2 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 12 test cases the skill fixed. Same model, same prompt, with and without the skill.
Convert this frontmatter skills list into the reference section's Skills subsection: `skills: ['../../skills/db-migrating', 'skills/common/wow-generating-validation-reports']`.
| Checked | Without skill | With skill |
|---|---|---|
| Strips path prefixes so skills are named strictly as db-migrating and wow-generating-validation-reports | Missed | Passed |
| Formats skill names in backticks | Missed | Passed |
| Provides descriptive text following each skill name | Missed | Passed |
The instructions your model reads when the skill loads.
Standard structure for "Reference Documentation" sections in agent files to ensure consistent navigation and discoverability.
This Skill auto-loads when implementing agents or updating agent documentation sections.
All agents SHOULD include a "Reference Documentation" section near the end (before any appendices) with standardized subsections.
## Reference Documentation
**Project Guidance**:
- [CLAUDE.md](../../CLAUDE.md) - Primary guidance for Claude Code
- [Agent-specific convention](path/to/convention.md) - Domain-specific standards
**Related Agents**:
- `maker-agent` - Creates content for this domain
- `checker-agent` - Validates content (upstream dependency)
- `fixer-agent` - Fixes issues found by checker
- `related-domain-agent` - Related functionality
**Related Conventions**:
- [Primary Convention](path/to/convention.md) - Main standards this agent implements
- [Secondary Convention](path/to/convention.md) - Additional relevant standards
**Skills**:
- `primary-skill` - Main Skill for domain knowledge
- `wow-assessing-criticality-confidence` - Criticality assessment (if applicable)
- `wow-generating-validation-reports` - Report generation (if applicable)
test cases passed, vs 7 / 20 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.