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

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

80%Weight 40%Scale 1-5

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

Highly actionable, well-structured CLI-tool skill body with executable examples and a clean one-level reference to its bundled script. The main gap is the absence of a validation/verification step for the batch adopt operation, which caps workflow clarity.

Suggestions

Add an explicit verification checkpoint after `--adopt` (e.g., confirm the manifest is valid JSONL and report any assets that failed ffprobe), with a fix-and-retry loop, to lift workflow clarity above the batch-operation cap of 3.

Trim the repeated "one line / search noise on disk" framing to a single statement to tighten conciseness.

Surface the hidden `asset search` command and the >= v0.1.6 version requirement more prominently (or in a short setup section) rather than burying them in the final paragraph.

Dimension	Reasoning	Score
Conciseness	Mostly lean with tight tables and executable examples, but the "one line / search noise on disk" messaging recurs ("One verb, four types, zero context noise", "The agent gets back one line", "Candidates, scores, provenance stay on disk") as mild marketing padding that could be trimmed.	4 / 5
Actionability	Fully executable, copy-paste-ready commands covering all four media types with expected output, a flags table, an adopt example, and concrete install/auth steps — specific examples cover the common cases.	5 / 5
Workflow Clarity	The five-step "How it works" sequence is clear, but the batch `--adopt` operation ("Bulk-import existing assets/ into manifest") has no explicit validation/verification checkpoint or error-recovery loop, which caps workflow clarity at 3 per the batch-operations rule.	3 / 5
Progressive Disclosure	Well-organized into clearly labeled sections with a real one-level reference to `scripts/resolve.mjs` (verified present in the bundle); implementation lives in scripts/ while the overview stays in SKILL.md, with no nested references and easy navigation.	5 / 5
	Total	17 / 20 Passed

Description

92%Weight 40%Scale 1-5

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

A strong, specific description that clearly states both capability and trigger conditions in third person. Minor trigger-synonym gaps and a light dusting of brand phrasing ("Agent Media OS") keep it just shy of perfect on trigger coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record", plus "project cache, global cache, HeyGen catalog search, freeze, register" — giving comprehensive coverage of the domain's actions.	5 / 5
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") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural trigger terms in "Use when a composition needs background music, sound effects, images, or icons", but a few natural synonyms a user might say ("audio", "music", "logo") are absent, so it stops just short of comprehensive.	4 / 5
Distinctiveness Conflict Risk	Carves a clear media-resolution niche with distinct, specific triggers (BGM/SFX/image/icon for compositions) and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 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: cd9f3c1

Reviewed: 15 days 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.