CtrlK
BlogDocsLog inGet started
Tessl Logo

deep-exploration

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

54

Quality

60%

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

78%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 a tight, executable five-step workflow with concrete tool invocations, a fallback path, and a specified delivery format. It is well within token budget and appropriately structured for a short single-purpose skill.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence, naming concrete tools without explaining what they are; the only trimmable redundancy is the '**Objective**' paragraph, which restates the frontmatter description almost verbatim.

4 / 5

Actionability

Steps give concrete tool calls with parameters (search_youtube, get_video_transcript(video_id), generate_timestamp_url(video_id, timestamp)), specific counts ('3 to 5 videos', '2-sentence summary'), and an explicit fallback — only an example of the final Knowledge Report output is missing.

4 / 5

Workflow Clarity

A clear five-step sequence with an explicit fallback in step 2 and a mandatory step 4; operations are read-only so the destructive/batch validation cap doesn't apply, but there is no checkpoint verifying the generated links or summaries are accurate.

4 / 5

Progressive Disclosure

This is a single-task skill under 50 lines with no need for external references; its sections (Objective, Execution Steps, HTML Publishing Rule, Next Actions) are well-organized, which earns a 5 under the simple-skill guidance.

5 / 5

Total

17

/

20

Passed

Description

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

The description communicates a few concrete actions but is missing the entire video domain vocabulary: no 'video', 'YouTube', 'timestamp', or 'clip' anywhere, and no trigger guidance for when the skill applies. A user asking to 'find where in this video they discuss X' would not naturally trigger it.

Suggestions

Add the domain vocabulary users actually say: 'video', 'YouTube', 'transcripts', 'timestamps', 'clips' — e.g., 'Finds the exact moments in YouTube videos that answer a question by reading transcripts and generating timestamped links.'

Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to find, skip to, or cite specific moments in a video without watching it.'

Replace the non-natural term 'jump-links' with user-facing phrasing like 'direct timestamped links to key moments' so the description matches how users describe the need.

DimensionReasoningScore

Specificity

The description lists three concrete actions ("reading transcripts, synthesizing arguments, and generating direct jump-links to key moments") but never names the domain — 'video' or 'YouTube' is absent — and coverage is partial, matching the anchor for a few concrete actions without comprehensive domain coverage.

3 / 5

Completeness

The 'what' is clear (read transcripts, synthesize arguments, generate jump-links), but there is no 'Use when...' clause or any equivalent trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

The only keywords present are "transcripts", "arguments", "jump-links", and "key moments"; the natural terms a user would actually say — 'video', 'YouTube', 'timestamp', 'clip', 'find the part where' — are entirely missing, and 'jump-links' is not a phrase users naturally use.

2 / 5

Distinctiveness Conflict Risk

Timestamp-targeted jump-link generation is a distinct niche, but "reading transcripts, synthesizing arguments" is generic enough to overlap with general transcript-analysis or summarization skills, so overlap risk remains.

3 / 5

Total

11

/

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.