media-processing

Media processing utilities for images, audio, and video using FFmpeg and ImageMagick. Use when working with media conversion, optimization, or batch processing tasks.

Quality

58%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/media-processing/SKILL.md

Quality

Content

42%

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

This skill provides good organizational structure and appropriate progressive disclosure to reference materials, but critically lacks actionable content. It describes capabilities and scripts without showing any actual usage examples, command syntax, or executable code. For a media processing skill, concrete FFmpeg/ImageMagick commands and script invocation examples are essential.

Suggestions

Add concrete command-line examples for each script (e.g., `python scripts/batch_resize.py --input ./images --output ./thumbs --strategy thumbnail --size 200x200`)

Include at least one complete FFmpeg and one ImageMagick command example showing common operations

Add a validation step in the workflow for verifying output files exist and have expected properties after batch operations

Replace the abstract 'Capabilities' bullet points with executable code snippets demonstrating each capability

Dimension	Reasoning	Score
Conciseness	The content is reasonably efficient but includes some unnecessary sections like 'When to Use' and 'Key Principles' that explain concepts Claude already understands. The capabilities section describes what scripts do rather than showing how to use them.	2 / 3
Actionability	No executable code examples or concrete commands are provided. The skill describes scripts and capabilities abstractly but never shows actual usage syntax, command-line invocations, or copy-paste ready examples.	1 / 3
Workflow Clarity	Usage guidelines provide a reasonable sequence (check deps → dry-run → keep originals → document), but lacks explicit validation checkpoints or error recovery steps for batch media operations which are potentially destructive.	2 / 3
Progressive Disclosure	Well-structured with clear sections and appropriate references to external files (scripts/, references/). Navigation is clear with one-level-deep references to specific documentation files for deeper topics.	3 / 3
	Total	8 / 12 Passed

Description

75%

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

This is a competent description that clearly establishes its domain and includes an explicit 'Use when' clause. However, it could be stronger by listing more specific actions (e.g., 'resize, crop, convert formats, extract audio') and including more natural trigger terms users would actually say when requesting media tasks.

Suggestions

Add specific concrete actions like 'resize images, convert video formats, extract audio, create thumbnails, compress files' to improve specificity.

Include common file extensions and user terms like '.mp4, .jpg, .png, resize, compress, transcode, thumbnail' to improve trigger term coverage.

Dimension	Reasoning	Score
Specificity	Names the domain (media processing) and mentions tools (FFmpeg, ImageMagick), but actions are generic ('conversion, optimization, batch processing') rather than listing specific concrete actions like 'resize images, convert video formats, extract audio tracks'.	2 / 3
Completeness	Clearly answers both what ('Media processing utilities for images, audio, and video using FFmpeg and ImageMagick') and when ('Use when working with media conversion, optimization, or batch processing tasks') with an explicit 'Use when' clause.	3 / 3
Trigger Term Quality	Includes some relevant keywords ('images, audio, video, FFmpeg, ImageMagick, media conversion') but missing common user variations like 'resize', 'compress', 'transcode', 'thumbnail', 'mp4', 'jpg', 'png', or file extensions users would naturally mention.	2 / 3
Distinctiveness Conflict Risk	Clear niche focused on media processing with specific tool mentions (FFmpeg, ImageMagick) that distinguish it from general file handling or document processing skills. Unlikely to conflict with other skills.	3 / 3
	Total	10 / 12 Passed

Validation

100%

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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: siviter-xyz/dot-agent
Commit: 3376255

Reviewed: 4 months 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.