CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

talk-stage1-extract

Extracts and structures source material (articles, transcripts, notes) into a talk summary with narrative arc, themes, metrics, and gaps. Auto-detects REX vs Concept type. Use when starting a new talk from any source material or auditing existing material before committing to a talk.

71

Quality

89%

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

88%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, actionable instruction skill: numbered workflow, explicit inputs and gate, a complete output template with examples, metric extraction rules, anti-patterns, and a validation checklist. Its only flaws are minor redundancy in the 'Tips' section and an inline output template that could be split into a reference file for a leaner SKILL.md.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — the type-detection signal table and output template carry real information with no concept explanations — but the 'Tips' section partially repeats earlier guidance ('Hybrid sources... name both components clearly' restates the detection section), so minor instances could be trimmed, fitting the 4 anchor rather than 5.

4 / 5

Actionability

Fully concrete instruction-only guidance: exact output path 'talks/{YYYY}-{slug}-summary.md', a copy-paste-ready output template, worked metric examples ('`1,200 commits` over 7 months (Source: ...)'), explicit input requirements, and an AskUserQuestion gate — matching the top anchor.

5 / 5

Workflow Clarity

The 8 steps in 'What this skill does' are clearly numbered and sequenced, the AskUserQuestion gate handles missing metadata before proceeding, and an explicit validation checklist closes the process — matching the 5 anchor (clear sequence, explicit validation, checklist).

5 / 5

Progressive Disclosure

The single file is well-sectioned with the runtime-critical template inline and clearly signaled one-level 'Related' links, fitting the 4 anchor ('good structure; most content appropriately placed; minor organization gaps'); it is not 5 because the ~60-line output template could arguably live in a reference file, and not 3 because nothing is buried or inlined that clearly belongs elsewhere.

4 / 5

Total

18

/

20

Passed

Description

88%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: it states concrete capabilities in third person, explicitly names source formats, and includes a well-formed 'Use when...' clause with distinct triggers. The only weaknesses are a few missing natural synonyms and slight overlap potential with sibling talk-pipeline skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Extracts and structures source material (articles, transcripts, notes) into a talk summary with narrative arc, themes, metrics, and gaps' and 'Auto-detects REX vs Concept type' — covering the skill's outputs comprehensively, matching the top anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

It explicitly answers both: what ('Extracts and structures source material... into a talk summary with narrative arc, themes, metrics, and gaps') and when ('Use when starting a new talk from any source material or auditing existing material before committing to a talk'), with concrete trigger phrases matching the 5 anchor.

5 / 5

Trigger Term Quality

Natural phrases like 'articles, transcripts, notes', 'starting a new talk', and 'auditing existing material' give good keyword coverage, but common synonyms a user might say ('speech', 'presentation', 'draft', file extensions like .mdx) are missing, fitting the 4 anchor.

4 / 5

Distinctiveness Conflict Risk

The talk-pipeline niche ('talk summary', 'REX vs Concept', talk stages) is mostly distinct, but the shared 'talk' trigger domain creates minor overlap risk with the sibling pipeline stages referenced in the body (stage 2 research, stage 3 concepts, orchestrator), fitting the 4 anchor.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 3 suspicious

Warning

Total

14

/

16

Passed

Repository

FlorianBruniaux/claude-code-ultimate-guide

Path

examples/skills/talk-pipeline/stage-1-extract/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.