# Skill: [Skill Name]

**Purpose**: [One-line description]

## Trigger Conditions

Invoke this skill when:
- [Trigger 1]
- [Trigger 2]
- [Trigger 3]

## Capabilities

### 1. [Primary Capability]

[Code/template/instructions]

### 2. [Secondary Capability]

[Code/template/instructions]

## Common Errors & Solutions

| Error | Cause | Solution |
|-------|-------|----------|
| [Error 1] | [Cause] | [Solution] |

## Checklist

- [ ] [Step 1]
- [ ] [Step 2]

# Pattern: Repeated imports
detect:
  pattern: "from sqlmodel import"
  threshold: 3
  action: "Check if database skill covers this pattern"

# Pattern: Similar error handling
detect:
  pattern: "try:\n.*\nexcept.*Error"
  threshold: 3
  action: "Create centralized error handling skill"

# Pattern: Repeated API structure
detect:
  pattern: "@router\\.(get|post|put|delete).*async def"
  threshold: 5
  action: "Suggest CRUD generator skill"

# Pattern: Environment variables
detect:
  pattern: "os\\.getenv|settings\\."
  threshold: 5
  action: "Check if config skill covers all env vars"

EXISTING_SKILLS = [
    "neon-db-setup",       # Database connection
    "jwt-middleware",      # Authentication
    "cors-config",         # CORS handling
    "db-timeout-handler",  # DB timeout errors
    "build-error-handler", # Build errors
    "k8s-pod-crash-handler", # K8s debugging
]

def check_skill_gap(detected_pattern):
    """Check if pattern is covered by existing skills."""
    for skill in EXISTING_SKILLS:
        if skill_covers_pattern(skill, detected_pattern):
            return f"Use existing skill: {skill}"
    return f"NEW SKILL NEEDED: {detected_pattern}"

## Skill Usage Log

| Skill | Used | Success | Improvement Needed |
|-------|------|---------|-------------------|
| neon-db-setup | 5 | 5/5 | None |
| jwt-middleware | 3 | 2/3 | Add refresh token handling |
| cors-config | 4 | 4/4 | None |

New Pattern/Error Detected
│
├── Check existing skills
│   ├── Covered → Use existing skill
│   └── Not covered → Continue
│
├── Analyze pattern
│   ├── Code structure → Generate code template skill
│   ├── Configuration → Generate config skill
│   ├── Error handling → Generate error handler skill
│   └── Deployment → Generate deployment skill
│
├── Generate skill file
│   ├── Create SKILL.md with template
│   ├── Add trigger conditions
│   └── Include code snippets
│
└── Update skill inventory
    └── Add to EXISTING_SKILLS list

# Manual trigger for skill analysis
Auto-Architect: Analyze current project for skill gaps

# Suggest skills for next phase
Auto-Architect: What skills do I need for Phase IV?

# Generate new skill from pattern
Auto-Architect: Create skill for [repeated pattern description]