CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/speaker-toolkit

Two-skill presentation system: analyze your speaking style into a rhetoric knowledge vault, then create new presentations that match your documented patterns. Includes an 88-entry Presentation Patterns taxonomy for scoring, brainstorming, and go-live preparation.

Overall
score

95%

Does it follow best practices?

Validation for skill structure

Overview
Skills
Evals
Files

presentation-creator

skills/presentation-creator/SKILL.md

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that excels across all dimensions. It provides specific concrete actions in the process, comprehensive trigger terms covering various ways users might request presentation help, explicit 'Use this skill whenever...' guidance, and a distinctive focus on rhetorical patterns that sets it apart from generic presentation skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'distill intent from the user's prompt, jointly select rhetorical instruments, architect the talk structure, develop content with speaker notes, and iterate with the author.' Uses third person voice appropriately.

3 / 3

Completeness

Clearly answers both what (interactive spec-driven process with specific steps) AND when (explicit 'Use this skill whenever...' clause with comprehensive trigger scenarios including creating presentations, building talks, writing CFPs, and adapting existing content).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'presentation', 'talk', 'conference submission', 'slide deck', 'speaking engagement', 'CFP abstract', 'adapt an existing talk', 'topic they want to present on'. These are terms users would naturally use.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused on presentation creation with rhetorical patterns as a style guide. The emphasis on 'speaker's documented rhetoric patterns' and the specific process (spec-driven, rhetorical instruments) distinguishes it from generic presentation tools.

3 / 3

Total

12

/

12

Passed

Implementation

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an exemplary skill file that demonstrates excellent process documentation. It provides a clear 6-phase workflow with explicit gates, concrete templates and code examples, and appropriate progressive disclosure to external references. The skill correctly positions itself as defining process while the vault provides content, and handles edge cases (summary-only mode, missing profile) gracefully.

DimensionReasoningScore

Conciseness

The skill is lean and efficient, assuming Claude's competence throughout. No unnecessary explanations of basic concepts; every section serves a clear purpose with minimal padding.

3 / 3

Actionability

Provides concrete, executable guidance including Python code snippets, specific file paths, structured templates (Presentation Spec, Guardrail Check), and clear phase gates. The outline format and placeholder typing are copy-paste ready.

3 / 3

Workflow Clarity

Excellent multi-phase workflow with explicit gates at each phase, clear sequencing ('Do not skip phases. Do not write content before Phase 3'), validation checkpoints (guardrail checks), and iteration protocols. The table overview provides at-a-glance understanding.

3 / 3

Progressive Disclosure

Well-structured with clear one-level-deep references to external files (references/process.md, references/guardrails.md, references/patterns/_index.md, references/slide-generation.md). Main skill provides overview while appropriately deferring detailed content to referenced documents.

3 / 3

Total

12

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed