CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prepare-walkthrough-presentation

Transforms validated /linear-walkthrough artifacts into one presentation-ready deck outline per major codebase component. Use when the user asks to create a presentation, prepare a walkthrough deck, build an onboarding deck, produce an architecture review deck, or summarize a codebase for a technical audience. Requires walkthrough directory output -- reads unified walkthrough, per-section files, validation reports, coverage maps, entry points, and open questions -- then orchestrates four parallel agent phases to produce slide outlines with speaker notes, evidence references, and suggested visuals.

70

Quality

88%

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

85%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 orchestration skill: clear four-phase workflow with pre-flight validation, fact-check feedback loops, and clean separation of overview from detail via two real, well-signaled reference files. The only weaknesses are minor — artifact paths repeated across flowchart, tables, and orchestrator actions, and an undefined validator count (M) in Phase 3.

Suggestions

State the artifact paths once (e.g., in the per-phase deliverable tables) and trim their duplication in the mermaid flowchart and orchestrator-action bullets.

Specify how M is chosen in Phase 3 (e.g., 'spawn one validator per deck' or 'spawn ceil(N/2) validators') so the rotation rule is fully deterministic.

DimensionReasoningScore

Conciseness

The body is mostly lean — tables, exact paths, and no explanations of concepts Claude already knows — but artifact paths are repeated three times (mermaid flowchart nodes, per-phase deliverable tables, and orchestrator actions), which is trimming-able duplication. Fits anchor 4 (efficient, minor instances that could be trimmed); not 5 due to that redundancy, not 3 since there is no padded or unnecessary explanation.

4 / 5

Actionability

Guidance is concrete and executable — exact artifact paths, agent prompt context lists ('pass file paths — do not transcribe file contents'), named agent types, a 25k-character threshold with a named strategy, and an in-place correction procedure — but 'Spawn M parallel agents' in Phase 3 never defines how M is chosen. Fits anchor 4 (mostly executable with minor gaps); not 5 because of the undefined validator count, not 3 since everything else is specific and complete.

4 / 5

Workflow Clarity

Four phases are clearly sequenced with explicit validation checkpoints and feedback loops: pre-flight input validation ('If any required artifact is missing, stop and report which files are absent'), Phase 2 output verification ('Verify all expected deck outline files exist'), a dedicated Phase 3 fact-checking pass, and a correction loop ('spawn a new general-purpose agent per affected deck to apply the corrections'). This batch workflow has validation throughout, so the batch-cap does not apply; it matches anchor 5. Not 4: no validation gaps remain.

5 / 5

Progressive Disclosure

The body is an orchestration overview that delegates all detailed prompts and templates to two real, one-level-deep reference files, each signaled with exact section names ('Planning Agent Instructions', 'Deck Outline Format', 'Presentation Crosswalk Format') that all exist in the bundle (verified against file headers). Matches anchor 5 (clear overview with well-signaled one-level-deep references, easy navigation); not 4 since both references and every cited section resolve.

5 / 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: concrete third-person actions, explicit inputs and outputs, and a clear 'Use when...' clause with multiple natural trigger phrases. The only weaknesses are minor — a few missing common synonyms for presentation/deck requests and a slightly over-broad 'create a presentation' trigger that could overlap a general presentation skill.

Suggestions

Add one or two common synonyms to the trigger clause (e.g., 'slides', 'slide deck', or 'onboarding presentation') so users phrasing the request those ways still match.

Tighten the first trigger phrase (e.g., 'create a presentation from a codebase walkthrough') so it does not fire for generic presentation/pptx requests that lack walkthrough artifacts.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions in third person — 'Transforms validated /linear-walkthrough artifacts into one presentation-ready deck outline per major codebase component', 'reads unified walkthrough, per-section files, validation reports, coverage maps, entry points, and open questions', and 'orchestrates four parallel agent phases to produce slide outlines with speaker notes, evidence references, and suggested visuals' — comprehensive coverage matching the anchor-5 example. Not 4: no minor gaps in action coverage; not below since nothing is vague or generic.

5 / 5

Completeness

Explicitly answers both what ('Transforms validated /linear-walkthrough artifacts into one presentation-ready deck outline per major codebase component... orchestrates four parallel agent phases') and when ('Use when the user asks to create a presentation, prepare a walkthrough deck, build an onboarding deck...'), with concrete trigger phrases — a direct match to the anchor-5 example. Not 4: the 'when' clause is fully explicit with multiple concrete triggers, not merely adequate.

5 / 5

Trigger Term Quality

Good natural-phrase coverage — 'create a presentation', 'prepare a walkthrough deck', 'build an onboarding deck', 'produce an architecture review deck', 'summarize a codebase' — but common user synonyms such as 'slides', 'slide deck', or a file extension like '.pptx' are absent. Fits anchor 4 (good coverage, a few natural terms missing), not 5 (coverage is not comprehensive with synonyms/extensions), clearly above 3.

4 / 5

Distinctiveness Conflict Risk

The walkthrough-artifact dependency gives it a clear niche, but the trigger phrase 'create a presentation' is broad and would also fire for a generic presentation/pptx skill where no walkthrough directory exists. Fits anchor 4 (mostly distinct, minor overlap risk with closely related skills); not 5 because of that overlap, not 3 since the core niche is unmistakable.

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: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

Jamie-BitFlight/claude_skills

Path

.claude/skills/prepare-walkthrough-presentation/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.