CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

talk-stage2-research

Performs git archaeology, changelog analysis, and builds a verified factual timeline by cross-referencing git history with source material. REX mode only (skipped automatically in Concept mode). Use when building a REX talk and you need verified commit metrics, release timelines, and contributor data from a git repository.

68

Quality

85%

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

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

A well-structured, highly actionable skill body: executable git commands, complete output templates for all three deliverables, explicit rules and anti-patterns, and a validation checklist. The main improvement opportunities are consolidating the repeated read-only emphasis and integrating validation checkpoints directly into the workflow steps rather than as a trailing checklist.

DimensionReasoningScore

Conciseness

The body is dense and functional — copy-paste git commands, complete output templates, and non-obvious domain tips ("Quiet periods in git velocity often correspond to hardest engineering challenges") — with no explanations of concepts Claude already knows. It falls short of lean because the read-only constraint is repeated four times ("read-only commands only", "Read-only only", the anti-pattern "Running git commands that modify the repository", and the checklist "Only read-only git commands executed"), which could be consolidated.

4 / 5

Actionability

Fully executable guidance throughout: the git command block is copy-paste ready (commits by month, shortlog, first/last date, merges, tags, velocity peaks), the three output templates are complete markdown specs with named file paths, and fallback handling is specified ("If the CHANGELOG has no version tags, fall back to date-based anchoring"). This matches the level-5 anchor — specific commands cover the common cases; level 4 would require missing key details, and none are apparent.

5 / 5

Workflow Clarity

The six numbered steps (read summary → git archaeology → changelog analysis → cross-reference → build timeline → write outputs) give a clear sequence, and a dedicated validation checklist plus conflict-flagging rules ("flag inconsistencies between sources, don't pick one arbitrarily") provide most checkpoints. It stops short of level 5 because the validation checklist sits in a separate section rather than being embedded as checkpoints in the step sequence, and there is no explicit validate-fix-retry feedback loop (acceptable here since operations are read-only, so the destructive/batch cap does not apply).

4 / 5

Progressive Disclosure

The body is well organized with clear section headers (Input, Output, Git Commands, Output formats, Key rules, Anti-patterns, Validation checklist, Tips, Related), and the Related links to sibling skills are clearly signaled one level deep. With no bundle files provided and ~90 lines of output templates inlined, structure is good but the skill exceeds the under-50-lines exception and the templates could arguably live in a references/ file — a minor organization gap consistent with level 4 rather than level 5's clean reference split.

4 / 5

Total

17

/

20

Passed

Description

83%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 in third-person voice with an explicit and concrete "Use when..." trigger clause, clear mode boundaries, and specific named deliverables. Its weaknesses are minor: a few missing natural synonyms and slight ambiguity against closely related git-analysis and sibling-stage skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Performs git archaeology, changelog analysis, and builds a verified factual timeline by cross-referencing git history with source material" — plus concrete deliverables ("verified commit metrics, release timelines, and contributor data"). It falls between anchors: more actions than the level-4 example but coverage is not fully comprehensive (inputs/outputs and the sibling-stage handoff are unstated), so an even score is appropriate.

4 / 5

Completeness

Both parts are explicit: the "what" is the opening verb chain ("Performs git archaeology, changelog analysis, and builds a verified factual timeline...") and the "when" is a concrete trigger clause ("Use when building a REX talk and you need verified commit metrics, release timelines, and contributor data from a git repository"), plus an explicit mode boundary ("REX mode only (skipped automatically in Concept mode)"). This clearly matches the level-5 anchor with concrete trigger phrases; level 4 would require the when-clause to be less explicit than it is.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "git history", "changelog", "commit metrics", "release timelines", "contributor data", "git repository" are phrases a user building a talk from a repo would plausibly say. It misses common synonyms (e.g. "change log", "release notes", "git stats"), so it does not reach the comprehensive level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The "REX talk" framing and REX-mode scoping carve a clear niche, but there is minor overlap risk with closely related skills: generic changelog-generation skills and the sibling REX pipeline stages (Stage 1/Stage 3), which the description does not disambiguate against. It fits the "mostly distinct; minor overlap risk" anchor rather than level 5's "minimal conflict risk".

4 / 5

Total

17

/

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