CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

youtube-hooks-scripts

Generate, review, and refine high-retention technical YouTube hooks, outlines, and scripts. Use when the user wants video scripting tailored to a topic, audience, runtime, and evidence-bound claims.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 well-organized, efficient, and honest about evidence boundaries, with a clear workflow and a properly signaled one-level reference structure. Its main weakness is actionability: it tells Claude what to identify but never shows what a good hook, outline, or script output actually looks like, and several constraint lines are generic boilerplate irrelevant to a writing task.

Suggestions

Add 1-2 concrete output examples (e.g., a worked hook with promise/tension/payoff labeled, or a short outline skeleton) so the Examples section demonstrates the artifact rather than only listing user prompts.

Replace the generic repo/destructive-command constraint boilerplate with constraints specific to video scripting (e.g., how to handle unverified metrics or client-provided claims).

Make the validation checkpoints checkable: define what 'the payoff answers the hook' means (e.g., each hook promise maps to a specific script section) so step 5 is a test rather than a vibe.

DimensionReasoningScore

Conciseness

Mostly lean, well-sectioned bullet lists with no explanations of concepts Claude already knows. However, parts of Constraints ('Make repo-owned changes only after confirming the target path', 'Do not run destructive commands') and 'Start with 2-3 focused surfaces before expanding scope' read as generic template boilerplate that does not earn its place in a video-scripting skill. Anchor 4 ('minor instances that could be trimmed') fits better than anchor 5.

4 / 5

Actionability

The workflow gives directive steps ('Identify the opening promise, viewer tension, and concrete payoff') and concrete input/output contracts, but no concrete output artifacts: no hook structures or formulas, no example hook or outline format, and the Examples section shows sample user prompts rather than example outputs. This lands on anchor 3 ('some concrete guidance but incomplete; missing key details') rather than 4, which expects mostly executable guidance.

3 / 5

Workflow Clarity

A clear six-step sequence with explicit checkpoints (step 5's payoff check, step 6's fail-fast) and a dedicated Validation section. Not anchor 5 because the checkpoints are qualitative with undefined criteria — nothing specifies what makes a payoff 'answer' the hook or how to judge audience fit — leaving minor validation gaps characteristic of anchor 4.

4 / 5

Progressive Disclosure

A ~75-line body organized into clear sections, with a dedicated Progressive Disclosure section that signals the active reference files (references/contract.yaml, references/evals.yaml, references/task-profile.json — all verified to exist) with their purposes, and points to archived long-form context by path. References are one level deep and well-signaled, matching the anchor-5 'clear overview with well-signaled one-level-deep references' example.

5 / 5

Total

16

/

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 description: third person, concise, with concrete verbs, named artifacts, and an explicit 'Use when' clause with specific trigger conditions. The only gap is modest synonym coverage for how users phrase video-scripting requests.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions ('Generate, review, and refine') applied to named artifacts ('high-retention technical YouTube hooks, outlines, and scripts'), comprehensively covering the skill's scope in third person. Matches the anchor-5 example pattern of several concrete verbs with concrete objects, so it sits above the anchor-4 'minor gaps in coverage' case.

5 / 5

Completeness

Explicitly answers both what ('Generate, review, and refine high-retention technical YouTube hooks, outlines, and scripts') and when ('Use when the user wants video scripting tailored to a topic, audience, runtime, and evidence-bound claims') with concrete trigger conditions. This mirrors the anchor-5 example structure of a full capability list plus an explicit 'Use when' clause.

5 / 5

Trigger Term Quality

Includes natural terms users would say — 'YouTube', 'hooks', 'outlines', 'scripts', 'video scripting' — but common phrasings like 'write a video script' or 'YouTube video' are absent. Good coverage per the anchor-4 example ('PDF files, forms, document extraction'), but short of anchor-5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (technical YouTube video scripting) with distinct triggers ('YouTube', 'hooks', 'video scripting') that no generic writing or documentation skill would claim. Minimal conflict risk, matching the anchor-5 'clear niche with distinct triggers' example.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Skills/content-publishing/youtube-hooks-scripts/SKILL.md

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.