Example Complete Skill

When to Use This Skill

Primary Triggers (Explicit)

Use this skill when the user says:

• "perform complex task"
• "implement advanced pattern"
• "handle multiple scenarios"
• "need comprehensive validation"

Contextual Triggers (Implicit)

Use this skill when:

• Domain is complex with multiple patterns
• Users need both basic and advanced guidance
• Validation and testing are important
• Task has many edge cases or variations

Purpose

Provide comprehensive guidance for complex tasks that require:

• Core concepts and workflows in SKILL.md
• Extensive reference documentation
• Multiple working examples for different scenarios
• Validation and testing utilities

Core Concepts

Concept 1: Fundamental Pattern

The foundational approach for this domain:

[Brief explanation with essential code]

Key principles:

• Principle 1 - Core idea
• Principle 2 - Core idea
• Principle 3 - Core idea

Concept 2: Standard Workflow

The recommended workflow:

1. Preparation - Set up requirements
2. Implementation - Apply core pattern
3. Validation - Verify correctness
4. Testing - Ensure reliability
5. Iteration - Refine based on results

Concept 3: Advanced Patterns

For complex scenarios, see

references/advanced.md

Quick overview:

• Pattern A - For scenario X
• Pattern B - For scenario Y
• Pattern C - For scenario Z

Quick Reference

Common Tasks

./scripts/validate.sh

./scripts/validate.sh --strict

./scripts/test.sh

./scripts/check-structure.sh

Key Patterns

examples/basic-example.sh

references/patterns.md

references/advanced.md

Validation

Verify implementation using provided scripts:

# Basic structure validation
./scripts/validate.sh path/to/implementation

# Strict validation (all checks)
./scripts/validate.sh --strict path/to/implementation

# Run full test suite
./scripts/test.sh path/to/implementation

Manual validation checklist:

• Structure matches requirements
• Core concepts applied correctly
• Edge cases handled
• Tests pass
• Documentation complete

Additional Resources

Reference Files

Detailed documentation in

references/

• references/patterns.md

  - Comprehensive pattern catalog with examples

• references/advanced.md

  - Advanced techniques and edge cases

• references/troubleshooting.md

  - Common issues and solutions

• references/migration.md

  - Upgrading from older approaches (if applicable)

Working Examples

Complete examples in

examples/

• examples/basic-example.sh

  - Simple implementation for common case

• examples/intermediate-example.sh

  - Moderate complexity scenario

• examples/advanced-example.sh

  - Complex scenario with edge cases

• examples/complete-example/

  - Full-featured implementation

Utility Scripts

Tools in

scripts/

• scripts/validate.sh

  - Structure and correctness validation

• scripts/test.sh

  - Automated testing utility

• scripts/check-structure.sh

  - File organization checker

• scripts/generate-template.sh

  - Scaffold new implementation

Progressive Disclosure

This skill uses three-level loading:

1. Always loaded: This SKILL.md with core concepts (~2,000 words)
2. Load as needed: Reference files for detailed patterns
3. Copy/execute: Examples and scripts when required

Keep SKILL.md focused on essential workflows. Move detailed content to references/.

Summary

This complete skill structure provides:

• Lean SKILL.md with essential concepts (1,500-2,500 words)
• Comprehensive reference documentation (in references/)
• Multiple working examples (in examples/)
• Validation and testing utilities (in scripts/)
• Progressive disclosure for efficient context usage

Use this structure for complex domains requiring extensive documentation and tooling.