Skip to content

[P1] Move inline code examples to examples/ directories #12

@michael-wojcik

Description

@michael-wojcik

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)

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions