---
name: skill-name
description: Clear description of what skill does and when to use. USE WHEN user says 'trigger phrase', 'another phrase', or requests this capability.
---

# Skill Name

## When to Activate This Skill
- User requests X
- User says "trigger phrase"
- Task involves Y capability
- Related intent Z

## Core Workflow

[Main instructions in imperative form - verb-first, actionable steps]

### Step 1: [Action]
[Specific instructions]

### Step 2: [Action]
[Specific instructions]

## Key Commands / Tools

```bash
# Primary command
command-example --flag value

# Alternative usage
command-example -u "url" --option
```

## Common Patterns

### Pattern 1: [Use Case Name]
[Instructions for this specific use case]

```bash
# Example command
command "input" -p pattern
```

### Pattern 2: [Use Case Name]
[Instructions for another use case]

```bash
# Example command
command -f file.txt --process
```

## Examples

```bash
# Example 1: Basic usage
command "simple input" -p basic

# Example 2: Advanced usage
cat file.txt | command -p advanced --output result.json

# Example 3: With URL
command -u "https://example.com" -p pattern
```

## Options / Configuration

- `--flag1`: What it does
- `--flag2`: What it does
- `-p pattern`: Pattern selection

## Supplementary Resources

For advanced usage: `read ${PAI_DIR}/docs/[resource].md`
For related tools: `read ${PAI_DIR}/docs/[tool].md`

## Key Principles

1. Principle 1 - Brief explanation
2. Principle 2 - Brief explanation
3. Principle 3 - Brief explanation