video-merger

Concatenate a directory of numbered MP4 segments (1_*.mp4, 2_*.mp4, ...) into one MP4 with optional fade transitions, unified resolution/fps/codec. Pure ffmpeg wrapper, no LLM. Trigger when a workflow has produced several short clips that need stitching into a final reel.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./src/opensquilla/skills/bundled/video-merger/SKILL.md

Quality

Content

57%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 well-structured, concise skill body for a single-purpose ffmpeg wrapper, weakened by a missing executable example invocation, an unspecified chunk-mode command, and references to install scripts that are not actually bundled. Batch operation also lacks explicit validation checkpoints.

Suggestions

Add a concrete, copy-paste-ready 'python merge.py --input ... --output ...' example covering both full and chunk modes, including the exact --chunk-duration flag since the entrypoint does not template it (improves actionability).

Add a short sequenced workflow with validation checkpoints: verify ffmpeg/ffprobe are present, verify segments match ^\d+_.*\.mp4$ and share resolution/fps, then run — with a re-check on failure (improves workflow_clarity for this batch operation).

Either bundle the referenced install.ps1 and install.sh scripts under scripts/ or remove the 'run the bundled installer' references so all cited paths exist (improves progressive_disclosure reference integrity).

Dimension	Reasoning	Score
Conciseness	The body is lean and avoids explaining concepts Claude already knows (no 'what is ffmpeg/MP4' padding); inputs table and failure modes are tight, though the install-hints table and the chunk_duration note carry minor redundancy.	4 / 5
Actionability	The inputs table and --ffmpeg-path/--ffprobe-path flags are concrete, but there is no complete executable example invocation, chunk mode lacks a concrete command ('use a direct shell call' is hand-wavy), and the referenced install.ps1/install.sh bundled installers do not exist in the bundle.	3 / 5
Workflow Clarity	This is a batch operation over multiple segments, and the body lacks an explicit sequenced workflow with validation checkpoints; the failure-modes section gives error-to-fix mapping but no validate-then-proceed loop, so the batch-operation cap holds at 3.	3 / 5
Progressive Disclosure	Sections are well-organized and the heavy logic is correctly split into scripts/merge.py, but the body references install.ps1 and install.sh as 'the bundled installer' yet neither file exists in the bundle — a reference-integrity defect that prevents a higher score.	3 / 5
	Total	13 / 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 the capability and an explicit trigger condition, with a distinctive numbered-segment contract. Only minor gap: a few common user synonyms for video joining are absent.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions — 'Concatenate a directory of numbered MP4 segments ... into one MP4', 'optional fade transitions', 'unified resolution/fps/codec' — giving comprehensive coverage of what the skill does.	5 / 5
Completeness	Explicitly answers both what ('Concatenate ... into one MP4 with optional fade transitions, unified resolution/fps/codec') and when ('Trigger when a workflow has produced several short clips that need stitching into a final reel') with a concrete trigger phrase.	5 / 5
Trigger Term Quality	Good keyword coverage including 'MP4 segments', 'short clips', 'stitching into a final reel', 'fade transitions', and the .mp4 extension, but missing common natural synonyms like 'merge', 'join', or 'combine videos' a user might say.	4 / 5
Distinctiveness Conflict Risk	The numbered-segment naming contract (1_.mp4, 2_.mp4, ...) and ffmpeg-wrapper framing carve a clear niche with minimal overlap risk against other skills.	5 / 5
	Total	19 / 20 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 — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	13 / 16 Passed

Repository: TokenRhythm/opensquilla
Path: src/opensquilla/skills/bundled/video-merger/SKILL.md
Commit: 94ac35e

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