CtrlK
BlogDocsLog inGet started
Tessl Logo

creative-insight-analyzer

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

56

Quality

64%

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

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

The body is an efficient, actionable instruction set with concrete tool calls, a clear sequenced workflow, and useful validation checkpoints, appropriately sized as a single-file skill. Its weaknesses are modest: no error-path guidance, a duplicated step number, and a few under-specified tool usages.

Suggestions

Fix the duplicated step numbering (two consecutive steps are numbered '3') and convert bold labels to markdown headings for cleaner navigation.

Add an explicit error-path step: what to do when the video ID is invalid, the video is not found, or no transcript is available.

Specify the arguments/usage for `search_youtube` and `publish_file`, since both are invoked but never defined.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no explanations of concepts Claude already knows, and the long verbatim disclaimer quote is justified since it is an exact required output. Only minor trimming opportunities exist (the Objective paragraph repeats the frontmatter description). Not 5 because of that mild duplication and slightly padded phrasing in the deliverable list.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: named tool calls (`search_youtube`, `get_video_details`, `get_video_transcript(video_id)`), an exact mandatory output message, and an explicit report structure (Hook, Visual Elements, Rhythm & Retention, Actionable Takeaway). Not 5 because argument details for `search_youtube` and usage of `publish_file` are unspecified.

4 / 5

Workflow Clarity

The sequence (locate → validate → disclaimer → metadata audit → transcript → synthesize → deliver → next actions) is clear, with checkpoints such as confirming duration/metadata and asking the user about >20-minute videos. Not 5 because there are no error-recovery paths (invalid video ID, transcript unavailable) and step numbering is duplicated (two steps numbered '3').

4 / 5

Progressive Disclosure

As a single-file skill under 50 lines with no external references needed, the content is well organized into labeled sections (Objective, Execution Steps, Deliverable, Next Actions). Not 5 because organization has minor flaws: bold labels instead of proper headings, a duplicated step number, and the report-format spec embedded inside the step list rather than as its own section.

4 / 5

Total

16

/

20

Passed

Description

53%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 concise, concrete description with a clear 'what' and a distinct niche, weakened by the complete absence of any 'when to use' trigger guidance and missing common trigger synonyms like 'YouTube' or 'engagement'. It reads as a capability statement rather than a discovery-friendly description.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user asks to analyze a viral or high-performing YouTube video, or wants creative insights on why a video performed well.'

Include natural user phrasings such as 'YouTube', 'video performance', 'engagement', and 'retention' to broaden trigger-term coverage.

Briefly enumerate the analysis dimensions covered (hook, pacing, visual elements) so the description matches the body's actual scope.

DimensionReasoningScore

Specificity

The description names the domain and 1-2 concrete actions ("Deconstructs high-performing or viral videos", "extract actionable creative insights from metadata and transcript") with specific inputs, but coverage is not comprehensive — the body's analysis of hooks, pacing, visual elements, and retention is absent. It sits between the 1-2-action anchor (3) and several-specific-actions anchor (4), but the clear coverage gap keeps it at 3.

3 / 5

Completeness

The 'what' is clear (deconstructs viral videos to extract insights from metadata and transcript), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Terms like "viral videos", "high-performing", "creative insights", "transcript", and "metadata" are natural and relevant, but common variations users would say are missing — no "YouTube", "analyze video performance", "engagement", or "retention". Not the 4 anchor because a few obvious natural terms are absent.

3 / 5

Distinctiveness Conflict Risk

The viral-video creative-analysis niche is well-differentiated with distinct triggers unlikely to fire for unrelated skills. Not 5 because there is minor overlap risk with adjacent video-marketing/audit skills (e.g., the ABCD framework audit referenced in the body).

4 / 5

Total

13

/

20

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.

Validation — 16 / 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.