claude-configs/skills/create-skill/templates/CLAUDE-template.md

# Skill Name - Comprehensive Guide

## 🎯 PURPOSE: [HIGH-LEVEL GOAL IN CAPS]

**[Value proposition - what this skill enables and why it matters]**

This guide covers:
- [Major topic 1]
- [Major topic 2]
- [Major topic 3]
- [Major topic 4]

## 📚 WHAT IS [MAIN CONCEPT]?

### Definition

[Detailed explanation of the core concept, capability, or methodology]

### Key Concepts

- **Concept 1**: Detailed explanation
- **Concept 2**: Detailed explanation
- **Concept 3**: Detailed explanation

### [Main Approach] vs [Alternative Approach]

**The Problem [Alternative] Solves:**
- Problem 1
- Problem 2
- Problem 3

**Why [Main Approach] Is Different:**
- ✅ Advantage 1 with explanation
- ✅ Advantage 2 with explanation
- ✅ Advantage 3 with explanation
- ✅ Advantage 4 with explanation

**[Alternative] documentation when you have [better method] = [problem statement].**

## 🏗️ ARCHITECTURE / METHODOLOGY

### Overall Framework

[Detailed explanation of the methodology or architecture]

### Core Components

**Component 1:**
- Purpose
- How it works
- When to use
- Integration points

**Component 2:**
[Same structure]

### System Diagram / Workflow Overview

```
[ASCII diagram or structured breakdown of system]
```

## 🚀 THE [MAIN WORKFLOW NAME]

**[Brief description of the workflow approach]**

### Phase 0: [Setup/Foundation]
**Command:** `/command-name` (if applicable)

[Detailed instructions for this phase]

**Objectives:**
- Objective 1
- Objective 2
- Objective 3

**Output:**
- Output file 1 - Description
- Output file 2 - Description
- Automatically captured to [location]

**Notes:** [Important notes about this phase]

### Phase 1: [Next Phase Name]
**Command:** `/command-name`

[Detailed instructions]

**Objectives:**
- Objective 1
- Objective 2

**Output:** [What gets created]

### Phase 2: [Next Phase Name]
[Continue for all phases]

**🏁 Goal: [Summary of what the complete workflow achieves]**

## 🔧 OPTIONAL [ENHANCEMENT] COMMANDS

These enhance [aspect] throughout the process:

### `/command-name-1`
**When:** [When to use this command]
- Purpose and benefits
- What it does
- How it improves results

### `/command-name-2`
**When:** [When to use this command]
- Purpose and benefits
- What it does
- How it improves results

## 🎯 BEST PRACTICES

### [Category 1]

- **Practice 1** - Detailed explanation with rationale
- **Practice 2** - Detailed explanation with rationale
- **Practice 3** - Detailed explanation with rationale

### [Category 2]

- **Practice 1** - Detailed explanation
- **Practice 2** - Detailed explanation

### [Category 3]

- **Practice 1** - Detailed explanation
- **Practice 2** - Detailed explanation

## 🛠️ TECHNOLOGY STACK / TOOLS

### Core Technology

[Detailed description of primary technology]

**Key features:**
- Feature 1
- Feature 2
- Feature 3

### Supporting Tools

**Tool 1:**
- Purpose
- Integration
- Usage

**Tool 2:**
[Same structure]

### Configuration

[Standard configuration or setup instructions]

## 📊 [ADDITIONAL MAJOR SECTION]

[Deep dive into important aspect]

### Subsection 1

[Detailed content]

### Subsection 2

[Detailed content]

## 🤖 [AGENTS / AUTOMATION] (if applicable)

### Agent 1 (Name)

**Training:** [Specialization]
**Voice:** [ID]
**Configuration:** `path`
**Parallel Execution:** [Capabilities]

**Responsibilities:**
- Phase 1: [What agent does]
- Phase 2: [What agent does]

[Continue for each agent]

### Agent Collaboration Protocol

[How agents work together]

**Workflow Handoff:**
1. Agent 1 completes [work]
2. Agent 2 validates [artifacts]
3. Communication protocol
4. Parallel execution rules

## 🔗 INTEGRATION POINTS

### With Other Skills

- **Skill 1**: How they integrate
- **Skill 2**: How they integrate

### With Tools

- **Tool 1**: Integration details
- **Tool 2**: Integration details

### With Infrastructure

[How this skill integrates with PAI infrastructure]

## 🚨 CRITICAL WARNINGS

### Warning Category 1

**Rule:** [Critical rule]

**Rationale:** [Why this matters]

**Consequences of violation:**
- Consequence 1
- Consequence 2

### Warning Category 2

[Same structure]

## 💡 CORE PRINCIPLES

1. **Principle 1** - Detailed explanation with examples and rationale
2. **Principle 2** - Detailed explanation
3. **Principle 3** - Detailed explanation
[Continue for all principles]

## 🎓 EXAMPLES AND PATTERNS

### Example 1: [Scenario Name]

**Context:** [Situation description]

**Approach:**
```
Step-by-step walkthrough with commands/code
```

**Result:** [What was achieved]

**Lessons:** [What to learn from this]

### Example 2: [Scenario Name]
[Same structure]

## 📈 SUCCESS METRICS / VALIDATION

### How to Measure [Quality]

- Metric 1: Target value
- Metric 2: Target value
- Metric 3: Target value

### Validation Checklist

- [ ] Check 1
- [ ] Check 2
- [ ] Check 3

## 🔧 TROUBLESHOOTING

### Problem 1: [Common Issue]

**Symptoms:**
- Symptom 1
- Symptom 2

**Diagnosis:**
[How to identify the problem]

**Solution:**
[Step-by-step fix]

### Problem 2: [Common Issue]
[Same structure]

## 📚 SUPPLEMENTARY RESOURCES

### Internal Resources
- Path to related documentation
- Path to components
- Path to examples

### External Resources
- Official documentation links
- Community resources
- Learning materials

## 🎯 QUICK REFERENCE

### Common Commands

```bash
# Task 1
command-sequence

# Task 2
command-sequence

# Task 3
command-sequence
```

### Decision Tree

**When to use approach A:**
- Condition 1
- Condition 2

**When to use approach B:**
- Condition 1
- Condition 2

## 📊 APPENDIX

### Glossary

- **Term 1**: Definition
- **Term 2**: Definition

### Configuration Reference

[Detailed configuration options]

### API Reference

[If applicable - API documentation]

---

## 🎯 SUMMARY

**Key Takeaways:**
1. Takeaway 1
2. Takeaway 2
3. Takeaway 3

**Remember:**
- Critical point 1
- Critical point 2
- Critical point 3

**Next Steps:**
- Action 1
- Action 2
- Action 3