export-skills

# Export Skills to Agent Skills Standard

## Overview

Export SpecWeave skills to the [Agent Skills](https://agentskills.io) open standard format. This enables skill portability across:

- **GitHub Copilot** (VS Code integration)
- **Gemini CLI**
- **Cursor**
- **Claude Code**
- Other Agent Skills-compatible tools

## Usage

```
/sw:export-skills [options]
```

### Options

| Option | Description |
|--------|-------------|
| `--output <dir>` | Output directory (default: `.agent-skills/`) |
| `--plugin <name>` | Export specific plugin (default: all) |
| `--skill <name>` | Export specific skill (default: all) |
| `--dry-run` | Preview without writing files |
| `--validate` | Validate output against Agent Skills spec |

## Output Structure

```
.agent-skills/
├── architect/
│   └── SKILL.md
├── security/
│   └── SKILL.md
├── qa-lead/
│   └── SKILL.md
└── pm/
    └── SKILL.md
```

## Field Mapping

| SpecWeave Field | Agent Skills Field | Notes |
|-----------------|-------------------|-------|
| `name` | `name` | Direct mapping |
| `description` | `description` | Direct mapping (max 1024 chars) |
| `allowed-tools` | `allowed-tools` | Convert comma to space-delimited |
| N/A | `license` | Add `Apache-2.0` by default |
| N/A | `compatibility` | Add `"Designed for Claude Code"` |
| N/A | `metadata.author` | Use plugin manifest author |
| N/A | `metadata.source` | Add `"SpecWeave"` |
| `visibility` | (not mapped) | Agent Skills uses file placement |
| `invocableBy` | (not mapped) | Agent Skills discovery is implicit |

## Execution Steps

### Step 1: Discover Skills

```bash
# Find all SKILL.md files in plugins
find plugins -name "SKILL.md" -type f
```

### Step 2: Convert Each Skill

For each SKILL.md:

1. Parse YAML frontmatter
2. Extract description (truncate to 1024 chars if needed)
3. Convert `allowed-tools` from comma to space-delimited
4. Generate Agent Skills-compliant frontmatter
5. Preserve markdown body content

### Step 3: Validate Output

Each exported skill mu