Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →majiayu000/documenting-agent-references
Standardized reference documentation section structure for agents - project guidance, conventions, related agents, and Skills.
Passed 21 of 22 test cases with the skill, and 6 of 22 without it.
and 21 more in the full report
15 fixed6 passed either way1 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 15 test cases the skill fixed. Same model, same prompt, with and without the skill.
In `governance/agents/core/config-checker.md`, I need to add the mandatory AGENTS.md link in the Project Guidance subsection. Should I link directly to `[AGENTS.md](AGENTS.md)` in the current directory or use a relative path to `CLAUDE.md`?
| Checked | Without skill | With skill |
|---|---|---|
| The response specifies linking `[AGENTS.md]` with a relative path pointing to `CLAUDE.md`. | Missed | Passed |
| The entry is placed under the bold label `**Project Guidance**:`. | 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**:
- [AGENTS.md](../../../CLAUDE.md) - Primary guidance for OpenCode
- [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 6 / 22 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.