enhancement: Add references/ directories for progressive disclosure

[galligan]

Skills Audit Finding: Missing Progressive Disclosure

Several skills lack references/ directories despite having substantial content that would benefit from progressive disclosure.

Skills Needing references/ Directory

Plugin	Skill	Lines	Status
baselayer	software-architecture	690	CRITICAL - over 500 lines
baselayer	research-and-report	403	Should have references
baselayer	root-cause-analysis	335	Should have references
baselayer	report-findings	300	Consider adding
baselayer	pattern-analysis	224	Consider adding
agent-kit	claude-code-configuration	415	Should have references
agent-kit	codex-configuration	353	Should have references

gitbutler Structure Issue

version-control skill has reference files in root instead of references/:

• REFERENCE.md → should be references/REFERENCE.md
• EXAMPLES.md → should be references/EXAMPLES.md

What to Move to references/

• Detailed configuration examples
• Platform-specific notes
• Troubleshooting guides
• Advanced patterns
• Edge cases and gotchas

Why This Matters

• Progressive disclosure keeps SKILL.md lean
• Reference files load on-demand, saving tokens
• Better organization aids maintenance

---

Generated from skills audit on 2026-01-10