CtrlK
BlogDocsLog inGet started
Tessl Logo

deep-exploration

Saves time by autonomously reading transcripts, synthesizing arguments, and generating direct jump-links to key moments.

67

Quality

80%

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/deep-exploration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The content is a tight, fully actionable YouTube timestamp-targeting workflow: concrete tool calls, an explicit fallback, a mandatory link-generation checkpoint, and clean section organization with no padding.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: it names tools and parameters directly without explaining what transcripts or timestamps are, and every line carries actionable instruction.

3 / 3

Actionability

It gives concrete, executable tool calls with arguments — `search_youtube`, `get_video_transcript(video_id)`, `get_video_details`, `generate_timestamp_url(video_id, timestamp)` — and an explicit rule against guessing the `?t=` parameter.

3 / 3

Workflow Clarity

A clearly sequenced 5-step process with an explicit fallback (transcript unavailable -> use `get_video_details`) and a MANDATORY checkpoint for link generation, giving a clear feedback path for the fragile timestamp-URL step.

3 / 3

Progressive Disclosure

The skill is a self-contained single-purpose workflow under 50 lines with no external bundle files, and it is organized into well-labeled sections (Objective, Execution Steps, HTML Publishing Rule, Next Actions), satisfying the simple-skill carve-out.

3 / 3

Total

12

/

12

Passed

Description

60%

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 action-oriented about what it does, but it omits explicit 'Use when...' trigger guidance and lacks the most natural user vocabulary (video/YouTube), capping completeness and distinctiveness at 2.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to find specific moments in YouTube videos without watching the whole video.'

Surface natural user terms like 'YouTube', 'video', and 'find the part where' so the description matches how users actually phrase the need.

DimensionReasoningScore

Specificity

The description lists three concrete actions — 'reading transcripts, synthesizing arguments, and generating direct jump-links to key moments' — each a specific operation rather than vague language.

3 / 3

Completeness

It clearly states what the skill does but provides no 'Use when...' clause or equivalent trigger guidance, so the 'when' half is missing rather than explicit.

2 / 3

Trigger Term Quality

Terms like 'transcripts' and 'jump-links' are relevant but the description omits common natural phrases a user would say (e.g., 'YouTube', 'video', 'find the part where'); 'autonomously' and 'key moments' are slightly abstract.

2 / 3

Distinctiveness Conflict Risk

The niche is fairly specific (transcript-based video targeting), but without explicit triggers and with no mention of the video/YouTube domain it could overlap with general summarization or link-generation skills.

2 / 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.