media-use

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Quality

Content

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is concise, highly actionable, and well-structured with verified bundle references. Its only weakness is workflow clarity: the batch adopt and freeze/register steps lack an explicit validation or verification checkpoint.

Suggestions

Add an explicit validation step after `--adopt` (e.g. re-read `.media/index.md` or run a manifest integrity check) so the batch import has a verification checkpoint before relying on the adopted records.

Include a brief verify/feedback step in 'How it works' after freeze/register (e.g. confirm the frozen file exists and the manifest record was written) to turn the sequence into a validated loop.

Note what to do when a resolve falls through to "no provider could resolve" — a one-line recovery hint (retry, check `heygen` on PATH/key) would close the error-recovery gap.

Dimension	Reasoning	Score
Conciseness	Lean and efficient — terse intro, compact tables for types/flags/tools, and command examples with expected output; it does not explain concepts Claude already knows and every section earns its place.	3 / 3
Actionability	Fully executable commands with real flags and copy-paste-ready examples showing concrete output lines, plus specific install/auth steps; matches the executable-and-complete anchor.	3 / 3
Workflow Clarity	The 5-step resolve cascade is clearly sequenced, but the batch `--adopt` operation and the resolve/freeze step lack an explicit validation or verification checkpoint, so per the batch-operation guideline workflow clarity is capped at 2 rather than reaching the level-3 explicit-checkpoint anchor.	2 / 3
Progressive Disclosure	Well-organized sections with the detailed implementation delegated to the real referenced `scripts/resolve.mjs` bundle file (verified to exist), keeping the body an overview with one-level-deep, clearly signaled references.	3 / 3
	Total	11 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, third-person, and answers both what the skill does and when to use it with natural trigger terms. It is concise yet comprehensive, with no vague fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "resolve any media need", "freeze, register", and the explicit cascade "project cache, global cache, HeyGen catalog search, freeze, register" across four named media types, matching the multiple-specific-actions anchor.	3 / 3
Completeness	Explicitly answers both what ("resolve any media need into a frozen local file + ledger record") and when ("Use when a composition needs background music, sound effects, images, or icons"), satisfying the both-what-and-when anchor.	3 / 3
Trigger Term Quality	Includes natural user terms "background music, sound effects, images, or icons" plus BGM/SFX, covering what a user would actually say when they need media for a composition.	3 / 3
Distinctiveness Conflict Risk	Has a clear niche — freezing media into local files with a ledger for compositions — with distinct BGM/SFX/image/icon triggers unlikely to collide with general-purpose skills.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 2 missing, 2 deeper-than-1-level	Warning

	Total	15 / 16 Passed

Repository: calesthio/OpenMontage
Path: .agents/skills/media-use/SKILL.md
Commit: 0af32ce

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.