-
Notifications
You must be signed in to change notification settings - Fork 10
Open
Description
Summary
Extract inline code examples from SKILL.md files and move them to dedicated examples/ directories.
Source: docs/review/skill-audit-unified-review.md
Problem
Severity: HIGH
Estimated Lines Saved: 600-800
Root Cause: Inline code examples belong in examples/ directory (Root Cause #1)
Skills Most Affected
| Skill | Current Lines | Code Example Density |
|---|---|---|
| pact-testing-patterns | 724 | High |
| pact-frontend-patterns | 573 | High |
| pact-database-patterns | 642 | High (SQL examples) |
Rationale
Per Anthropic's Progressive Disclosure principle:
Tier 1: Metadata (name, description) - ~100 words
↓
Tier 2: SKILL.md body - Quick Reference → Decision Tree → Overview
↓
Tier 3: references/, templates/, examples/ - Loaded on demand
Code examples should be in Tier 3, loaded on demand rather than always consuming context.
Acceptance Criteria
- Code examples extracted from pact-testing-patterns
- Code examples extracted from pact-frontend-patterns
- Code examples extracted from pact-database-patterns
- examples/ directories populated with extracted code
- SKILL.md files reference examples/ instead of inline code
- 600-800 lines saved across affected skills
Estimated Effort
1-2 days
Labels
priority: high, type: refactor, affects: multiple-skills
📄 Full Audit Document Reference
See docs/review/skill-audit-unified-review.md for the complete unified skill audit.
Key Section: Token Impact Summary - "Move code examples to examples/" (Line 49)
Reactions are currently unavailable