CtrlK
BlogDocsLog inGet started
Tessl Logo

creative-insight-analyzer

Deconstructs high-performing or viral videos to extract actionable creative insights from metadata and transcript.

52

Quality

57%

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

Fix and improve this skill with Tessl

tessl review fix ./python/agents/youtube-analyst/youtube_analyst/skills/creative-insight-analyzer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%

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

The content is well-structured and uses concrete tools, but it is internally contradictory (promising visual analysis while disclaiming vision capability), has a numbering error, and lacks a validation step. Resolving the visual-analysis contradiction and adding an output-quality check would meaningfully improve it.

Suggestions

Reconcile the disclaimer with the 'Visual Elements' deliverable: either remove visual-only fields (editing pace, color grading, face-cam) the skill cannot assess, or relabel them as 'inferred from transcript/metadata only'.

Fix the duplicate step numbering (two '3.' steps) so the execution sequence is unambiguous.

Add an explicit validation/review checkpoint before delivering the report, e.g. confirming transcript coverage and that every report field is supported by the available metadata.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete tool calls, but the verbatim multi-line disclaimer and phrasing like 'This is critical for B2B creative strategy' add tokens that don't earn their place.

2 / 3

Actionability

Concrete tool calls are named (search_youtube, get_video_details, get_video_transcript, publish_file), but the 'Visual Elements' deliverable asks for editing pace, color grading, and face-cam usage that the disclaimer admits the skill cannot assess, making part of the guidance non-executable.

2 / 3

Workflow Clarity

Steps are numbered and sequenced, but there is a duplicate '3.' step and no explicit validation checkpoint or feedback loop on the analysis output, leaving checkpoints implicit.

2 / 3

Progressive Disclosure

The skill is under 50 lines with no bundle files and is organized into clear Objective, Execution Steps, and Next Actions sections, satisfying the simple-skill allowance.

3 / 3

Total

9

/

12

Passed

Description

57%

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

The description is specific and distinct but incomplete: it states what the skill does without any explicit 'when to use it' trigger guidance. Adding a 'Use when...' clause would lift completeness and trigger-term quality.

Suggestions

Append a 'Use when...' clause naming natural user triggers, e.g. 'Use when the user asks to analyze why a video went viral, deconstruct a high-performing video, or extract creative insights from a video transcript.'

Expand the action list to multiple concrete verbs (e.g. 'audit metadata, analyze the hook, map pacing, and synthesize a creative insight report') to reach the score-3 specificity anchor.

Add common term variations users would actually say (e.g. 'viral video analysis', 'YouTube breakdown', 'hook analysis').

DimensionReasoningScore

Specificity

Names the domain ('high-performing or viral videos') and a couple of actions ('Deconstructs', 'extract actionable creative insights from metadata and transcript'), but does not list multiple distinct concrete actions like the score-3 anchor.

2 / 3

Completeness

Clearly states what the skill does, but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 2 per the judging guidelines.

2 / 3

Trigger Term Quality

Contains some natural terms ('viral videos', 'high-performing videos', 'metadata', 'transcript') but lacks common variations and explicit user phrasing, falling short of full coverage.

2 / 3

Distinctiveness Conflict Risk

The combination of 'viral videos', 'creative insights', and 'metadata and transcript' carves a clear niche unlikely to trigger for unrelated skills.

3 / 3

Total

9

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
google/adk-samples
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.