Agent Skill
2/7/2026skill-with-references
Demonstrates progressive disclosure by loading reference documentation on demand. Shows how skills can include additional detailed documentation without loading everything upfront.
Y
yoshiwatanabe
0GitHub Stars
1Views
npx skills add yoshiwatanabe/yw-claude-marketplace-demo
SKILL.md
| Name | skill-with-references |
| Description | Demonstrates progressive disclosure by loading reference documentation on demand. Shows how skills can include additional detailed documentation without loading everything upfront. |
name: skill-with-references description: Demonstrates progressive disclosure by loading reference documentation on demand. Shows how skills can include additional detailed documentation without loading everything upfront.
Skill with References
Description: Demonstrates progressive disclosure by loading reference documentation on demand.
When to use: When explaining how skills can include additional documentation without loading everything upfront.
Workflow
- Initially, only this SKILL.md is loaded
- When detailed information is needed, load the appropriate reference document
- References are in the
references/subdirectory
Available References
guidelines.md- Detailed guidelines and best practices- Load these only when specifically needed
Key Points
- References are NOT loaded automatically
- Load references only when the conversation requires them
- This reduces token usage while maintaining deep knowledge availability
- Progressive disclosure = better performance
Example Usage
User asks: "What are the guidelines?"
Response: Load references/guidelines.md and provide the information.
User asks: "Tell me about this skill" Response: Explain from this SKILL.md only (don't load references yet).
Skills Info
Original Name:skill-with-referencesAuthor:yoshiwatanabe
Download