ffmpeg

Guide for using FFmpeg - a comprehensive multimedia framework for video/audio encoding, conversion, streaming, and filtering. Use when processing media files, converting formats, extracting audio, creating streams, applying filters, or optimizing video/audio quality.

Quality

78%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./claude/skills/ffmpeg/SKILL.md

Quality

Discovery

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.

This is a strong skill description that clearly identifies FFmpeg as the tool, lists specific capabilities, and provides explicit 'Use when' guidance with natural trigger terms. It follows third-person voice correctly and covers both the what and when comprehensively.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'video/audio encoding, conversion, streaming, and filtering' plus 'processing media files, converting formats, extracting audio, creating streams, applying filters, optimizing video/audio quality'.	3 / 3
Completeness	Clearly answers both what ('comprehensive multimedia framework for video/audio encoding, conversion, streaming, and filtering') and when ('Use when processing media files, converting formats, extracting audio, creating streams, applying filters, or optimizing video/audio quality').	3 / 3
Trigger Term Quality	Includes natural keywords users would say: 'FFmpeg', 'video', 'audio', 'encoding', 'conversion', 'streaming', 'filters', 'media files', 'extracting audio', 'formats'. Good coverage of common terms.	3 / 3
Distinctiveness Conflict Risk	Clear niche focused on FFmpeg and multimedia processing. The specific tool name 'FFmpeg' and media-specific terminology (encoding, streaming, filters) make it unlikely to conflict with other skills.	3 / 3
	Total	12 / 12 Passed

Implementation

57%

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

This skill excels at actionability with comprehensive, executable FFmpeg commands covering most use cases. However, it suffers from being overly verbose with unnecessary introductory content and lacks progressive disclosure - the entire reference is crammed into one file. Workflow clarity could be improved by adding explicit validation steps for complex operations like batch processing or streaming setup.

Suggestions

Remove the introductory paragraph and 'When to Use This Skill' section - Claude knows what FFmpeg is and when to use it

Split into multiple files: SKILL.md (quick start + common operations), STREAMING.md, FILTERS.md, CODECS.md with clear cross-references

Add explicit validation steps to workflows, e.g., 'After encoding, verify with: ffprobe output.mp4 | grep -E "codec|bitrate"'

Remove the 'Core Components' and 'Libraries' sections - these describe FFmpeg internals that don't help with task execution

Dimension	Reasoning	Score
Conciseness	The skill is comprehensive but includes some unnecessary explanations (e.g., 'FFmpeg is a comprehensive open-source multimedia framework...' introduction, 'When to Use This Skill' section listing obvious use cases). The core components and library descriptions add bulk without actionable value for Claude.	2 / 3
Actionability	Excellent executable code examples throughout - every operation has copy-paste ready commands with proper syntax. Examples cover basic to advanced use cases with specific parameters and real command-line invocations.	3 / 3
Workflow Clarity	Multi-step processes like two-pass encoding and concatenation are clearly sequenced, but validation/verification steps are largely missing. The 'Best Practices' mentions 'Test short clips first' and 'Verify output' but these aren't integrated into workflows as explicit checkpoints.	2 / 3
Progressive Disclosure	This is a monolithic 600+ line document with no references to external files. Content that could be split (streaming guide, filter reference, codec details) is all inline. The structure uses headers but everything is in one massive file.	1 / 3
	Total	8 / 12 Passed

Validation

81%

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

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (644 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	9 / 11 Passed

Repository: einverne/dotfiles
Commit: b1b2fe0

Reviewed: 27 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.