CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

76%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.

A highly actionable, token-efficient body with executable examples for every media type and a clear resolution cascade. Its main weakness is the absence of validation/verification checkpoints for the freeze and batch-adopt operations, which caps workflow clarity, alongside version-sensitive install details embedded in the main flow.

Suggestions

Add explicit validation steps to the workflow: after freeze, verify the file exists and probes cleanly (ffprobe duration/dimensions), and after `--adopt`, verify the manifest records and report any assets that failed to probe, with a fix-and-retry path.

Move the heygen install instructions and the '>= v0.1.6' version requirement into a short 'Setup' or 'Deprecated/old versions' section so time-sensitive details don't sit in the main operational flow.

Briefly document the `scripts/lib/` module layout (one line each) so an agent diving deeper than resolve.mjs can navigate the bundle without reading every file.

DimensionReasoningScore

Conciseness

The body is lean and operational — no padding, no explanations of concepts Claude already knows, and every section earns its tokens. It falls short of the level-5 anchor because of unpinned-down time-sensitive details: the 'heygen >= v0.1.6' version requirement and install/version instructions sit in the main flow rather than a deprecated/old-patterns section, which the guidelines say should penalize conciseness.

4 / 5

Actionability

Every command is copy-paste ready: the exact resolve invocation with flags, worked examples for all four types with real output lines ('resolved bgm_001 → .media/audio/bgm/bgm_001.mp3 (bgm, 25s)'), an adopt example, the flags table, and install/auth commands. Specific examples cover the common cases, matching the level-5 anchor.

5 / 5

Workflow Clarity

The 'How it works' section gives a clear 5-step cascade and the missing-CLI failure path is described, but there are no validation or verification checkpoints anywhere — nothing confirming the frozen file exists/probes correctly, and no verify step after the batch `--adopt` import. Per the guidelines, batch operations without validation cap workflow_clarity at 3, and this cap applies despite the otherwise clean sequence.

3 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled sections, and the referenced bundle path (`<SKILL_DIR>/scripts/resolve.mjs`) is a real file exactly one level deep, keeping search noise in scripts as designed. Minor gaps keep it at level 4 rather than 5: the ~120-line body inlines some material (install/version instructions, the index sample) that could live in a reference file, and the `scripts/lib/` modules and tests are present in the bundle but undocumented.

4 / 5

Total

16

/

20

Passed

Description

88%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 description that names the domain, enumerates the concrete cascade actions, and gives an explicit 'Use when...' trigger clause with natural terms. Its only weaknesses are a slightly buzzwordy 'Agent Media OS' opener, a few missing synonyms (photos, logos), and minor overlap risk on the broad words 'images'/'icons'.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full cascade: 'project cache, global cache, HeyGen catalog search, freeze, register', plus the outcome 'frozen local file + ledger record'. Coverage of the skill's scope is comprehensive, matching the level-5 anchor; only the 'Agent Media OS' branding is mildly fluffy.

5 / 5

Completeness

Both parts are explicit: the 'what' ('resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record... handles the full cascade') and the 'when' ('Use when a composition needs background music, sound effects, images, or icons'). This matches the level-5 anchor of clearly and explicitly answering both with concrete trigger phrases, and not the level-4 anchor where the 'when' could be more specific.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — 'background music, sound effects, images, or icons' plus BGM/SFX — which users would genuinely say. A few natural synonyms are missing (e.g., 'photos', 'logos', 'music track', file extensions), fitting the level-4 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — resolving/licensing external media assets via a specific cascade with a dedicated ledger — and unlikely to trigger for unrelated skills. Minor overlap risk remains with generic image/design or audio-generation skills triggered by 'images' or 'icons', placing it at the level-4 'mostly distinct; minor overlap risk' anchor rather than the minimal-conflict level-5 anchor.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

Reviewed

Table of Contents

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.