# E2E Spec: Skill REST API

## Overview
Test `/api/internal/skills` REST endpoints beyond basic CRUD.
Extends `task_api_spec.md` patterns with skill-specific behaviors.

## Test Cases

### Import Sources
- Markdown file import with front-matter
- Markdown file import without front-matter infers id/name from Markdown heading or filename
- Import with id/name form fields overrides inferred metadata for a single source
- Multipart import accepts multiple Markdown `file` parts and returns a batch result
- ZIP archive import with SKILL.md
- tar.gz archive import with SKILL.md
- Archive without SKILL.md returns error
- URL import downloads and imports
- Unsupported file type returns error listing supported types
- Force flag overwrites existing skill
- Non-force import of existing skill returns 409 with exists=true

### Content Storage
- Skill content stored at skills/{id}/SKILL.md
- Archive extra files extracted to skill directory
- Delete removes content directory

### Update Fields
- Update name, description, enabled fields
- Update preserves unchanged fields