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.
96
Quality
96%
Does it follow best practices?
Impact
96%
1.57xAverage score across 15 eval scenarios
rhetoric-knowledge-vault
skills/rhetoric-knowledge-vault/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 an excellent skill description that thoroughly explains its specialized purpose of analyzing presentation rhetoric and speaker style. It provides comprehensive detail on both capabilities and specific trigger phrases, uses proper third-person voice throughout, and carves out a distinct niche that won't conflict with general presentation tools.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'parses presentation talks', 'catalog specific rhetoric patterns', 'downloads YouTube transcripts', 'analyzes slides', 'generates a structured speaker profile', 'create a personalized presentation-creator skill'. Also enumerates specific patterns analyzed: 'opening hooks, humor style, pacing, transitions, audience interaction, slide design, and verbal signatures'. | 3 / 3 |
Completeness | Clearly answers WHAT (parses talks, catalogs rhetoric patterns, downloads transcripts, analyzes slides, generates speaker profiles) AND WHEN with explicit triggers listed at the end. The 'Triggers:' section provides clear guidance on when Claude should select this skill. | 3 / 3 |
Trigger Term Quality | Includes explicit trigger phrases that users would naturally say: 'parse my talks', 'analyze my presentation style', 'generate my speaker profile', 'how many talks have been processed'. Also includes domain-relevant terms like 'YouTube transcripts', 'PPTX files', 'Google Drive PDFs', 'rhetoric'. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche focusing specifically on rhetoric analysis and speaker style profiling. The combination of 'rhetoric patterns', 'speaker profile', and presentation-specific triggers like 'rhetoric vault' and 'rhetoric analyzer' make it unlikely to conflict with general presentation or document skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted, complex skill with excellent workflow clarity and actionability. The multi-step process is clearly sequenced with validation checkpoints, error handling tables, and explicit feedback loops. The progressive disclosure is exemplary with a reference table and appropriate externalization of detailed schemas. Minor verbosity in some sections prevents a perfect conciseness score.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some redundancy (e.g., repeated explanations of slide source hierarchy, multiple references to the same files). Some sections could be tightened, though most content earns its place given the complexity of the workflow. | 2 / 3 |
Actionability | Provides fully executable commands (yt-dlp, python-pptx, mlx_whisper), concrete JSON schemas, specific file paths, and copy-paste ready code snippets. The workflow steps are precise with exact commands and expected outputs. | 3 / 3 |
Workflow Clarity | Excellent multi-step workflow with clear sequencing (Steps 1-6), explicit validation checkpoints (error handling table, status tracking), feedback loops (re-validate after fixes, auto-regenerate profile), and clear decision trees for different scenarios. | 3 / 3 |
Progressive Disclosure | Well-structured with a clear reference table pointing to one-level-deep files (schemas.md, rhetoric-dimensions.md, pptx-extraction.md, etc.). Main content provides overview while detailed schemas and extraction procedures are appropriately externalized. | 3 / 3 |
Total | 11 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |