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
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 clearly articulates a specific, well-defined capability. It provides comprehensive detail about what the skill does (rhetoric pattern analysis across multiple dimensions), what inputs it handles (YouTube transcripts, PPTX, PDFs), and includes explicit trigger phrases. The description successfully 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:' section listing specific phrases that should activate 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 mentions natural file types like 'PPTX files', 'Google Drive PDFs', and 'YouTube transcripts'. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche focusing on rhetoric analysis and speaker style profiling. The specific domain (presentation rhetoric patterns, speaker profiles) and unique triggers ('rhetoric analyzer', 'rhetoric vault status', 'rhetoric knowledge base') 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 skill with excellent workflow clarity and actionability. The multi-step process is clearly sequenced with explicit validation checkpoints, error handling tables, and feedback loops. The progressive disclosure is effective with a clean reference table. Minor verbosity in some sections prevents a perfect conciseness score, but overall this skill demonstrates strong technical writing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy (e.g., repeated references to schemas and config fields across multiple sections). The table-based organization helps, but some sections could be tightened. | 2 / 3 |
Actionability | Provides concrete, executable commands (yt-dlp, gdown, python-pptx code), specific file paths, JSON schemas, and clear status values. The workflow steps are copy-paste ready with actual command syntax. | 3 / 3 |
Workflow Clarity | Excellent multi-step workflow with explicit sequencing (Steps 1-6), clear validation checkpoints (error handling table with status outcomes), batch processing with explicit gates, and feedback loops (clarification session, auto-regeneration triggers). | 3 / 3 |
Progressive Disclosure | Well-structured with a clear reference table pointing to one-level-deep files (schemas.md, rhetoric-dimensions.md, etc.). Main content stays focused on workflow while detailed schemas and extraction scripts 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 | |