example-skill

# Example Skill

**Purpose:** This skill exists to demonstrate the Skills-as-Containers pattern introduced in PAI v1.2.0. Use it as a template for creating your own skills.

## Architecture Overview

Skills in PAI v1.2.0 are organized as self-contained containers with:

### Core Components
- **SKILL.md** - Core skill definition with routing logic (you're reading it now!)
- **workflows/** - Specific task workflows for discrete operations
- **assets/** - Templates, references, and helper files

### Progressive Disclosure
1. **Metadata** (always loaded) - Name, description, triggers
2. **Instructions** (loaded when triggered) - This SKILL.md content
3. **Resources** (loaded as needed) - Individual workflow and asset files

## Included Workflows

This skill includes three example workflows demonstrating different complexity levels:

### 1. simple-task.md
**Purpose:** Basic single-step workflow
**Trigger:** User says "simple example", "basic task"
**Demonstrates:** Minimal workflow structure

### 2. complex-task.md
**Purpose:** Multi-step workflow with dependencies
**Trigger:** User says "complex example", "multi-step task"
**Demonstrates:** Structured workflow with validation

### 3. parallel-task.md
**Purpose:** Agent orchestration for parallel execution
**Trigger:** User says "parallel example", "parallel task"
**Demonstrates:** Multi-agent coordination pattern

## Routing Logic

Natural language automatically routes to the right workflow:

```
User Intent → Skill Activation → Workflow Selection → Execution

Example Flow:
"Show me a simple example"
    ↓ (matches trigger)
example-skill loads
    ↓ (analyzes intent: "simple")
simple-task.md selected
    ↓
Workflow executes
```

## Assets

This skill includes example assets in the `assets/` directory:
- `template.md` - Example template file
- `reference.md` - Example reference material

These demonstrate how to organize supporting resources.

## Usage Examples

### Basic Usage
```
User: "Show me a simple example"
→ Load