media-use

Turn an approved local asset into a stable project path and ledger record. This skill is an inventory and ingestion layer: it performs no web search, download, media generation, or voice synthesis.

For revisioned audition decisions, generated images/video, derivatives and the distinction between a reviewed asset and one actually used in a release, read review and derivative provenance. Keep those editorial records alongside the resolver manifest; do not pretend its existing flags implement a full editorial state machine.

Voice is outside this resolver. fish-audio-api is the bundled synthesis adapter. Respect supplied narration or a user-selected provider; prepare that audio through its supported route, then import the resulting local narration file and measured timing into the composition.

Public package setup

No media recordings, author library, review database or cache is included. Supply your own reviewed files and rights records. A new project can begin with an empty library; discovery may return no results. Use explicit --source ingestion when you already have a permitted file.

The project wrapper finds .agents/skills/media-use or the directory named by MEDIA_USE_SKILL_DIR. Its optional MEDIA_CATALOG points to a catalog within the project/workspace; --catalog overrides it. The resolver's optional MEDIA_USE_GLOBAL_CACHE_DIR selects a user-owned cache. These paths are configuration, not assets supplied by this release. Standalone resolver/catalog commands read environment variables; the scaffolded wrapper additionally reads the project .env.

Resolve

node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description-or-id>" --project <dir>