docs/README.md

# FFmpeg Media Toolkit Documentation

## Start here

- [Getting started](getting-started.md)
- [Installation](installation.md)
- [Agent workflows](agent-workflows.md)
- [CLI reference](cli-reference.md)
- [Declarative pipelines](pipelines.md)
- [Migration from legacy Bash](migration-from-bash.md)

The six guides above are the authoritative public flow. They explain what the
host can do, how to select a Skill or CLI action, how to validate a pipeline,
and how to migrate older scripts. Domain pages add operation-specific detail
without replacing that flow.

## Media domains

- [Video](video.md)
- [Image](image.md)
- [Audio](audio.md)
- [Conversion](conversion.md)
- [Composition](composition.md)
- [Streaming](streaming.md)
- [Diagnostics & repair](diagnostics.md)
- [Batch processing](batch-processing.md)

## Architecture / compatibility

- [Skill request examples](skill-request-examples.md)
- [Development and architecture notes](development/README.md)

- [Hardware acceleration status](hardware-acceleration.md)
- [Platform support & release validation](platform-support.md)
- [Migration from legacy Bash](migration-from-bash.md)
- [UX/progress architecture](development/ux-progress-agent-output.md)
- [Media capability expansion](development/media-capability-expansion.md)

The public documentation describes the stable CLI, package API, and
Skill-associated script surface. Future roadmap features are marked explicitly
and should not be inferred as implemented. Current validation is provided by
the repository scripts; old generated validation transcripts are not part of
the active documentation path.