cli-demo-generator
This skill should be used when users want to create animated CLI demos, terminal recordings, or command-line demonstration GIFs. It supports both manual tape file creation and automated demo generation from command descriptions. Use when users mention creating demos, recording terminal sessions, or generating animated GIFs of CLI workflows.
Install with Tessl CLI
npx tessl i github:fernandezbaptiste/claude-code-skills --skill cli-demo-generator90
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
89%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 well-structured skill description with explicit 'Use when' guidance and good trigger term coverage for CLI demo creation scenarios. The main weakness is that the specific capabilities could be more detailed - it mentions 'tape file creation' and 'automated demo generation' but doesn't elaborate on the full range of actions supported.
Suggestions
Add more specific concrete actions like 'configure typing speed', 'add pauses between commands', 'customize terminal themes', or 'export to multiple formats' to improve specificity
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (CLI demos, terminal recordings) and some actions (tape file creation, automated demo generation), but lacks comprehensive specific actions like 'record keystrokes', 'add timing delays', 'export to GIF format', etc. | 2 / 3 |
Completeness | Clearly answers both what (create animated CLI demos, terminal recordings, tape file creation, automated demo generation) AND when with explicit triggers ('Use when users mention creating demos, recording terminal sessions, or generating animated GIFs of CLI workflows'). | 3 / 3 |
Trigger Term Quality | Good coverage of natural terms users would say: 'animated CLI demos', 'terminal recordings', 'command-line demonstration GIFs', 'demos', 'recording terminal sessions', 'animated GIFs', 'CLI workflows' - these are terms users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on CLI/terminal demo creation and GIF generation - unlikely to conflict with general coding skills, video editing skills, or documentation skills due to specific 'tape file', 'terminal recording', and 'CLI demo' terminology. | 3 / 3 |
Total | 11 / 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-structured, highly actionable skill with excellent workflow clarity and appropriate progressive disclosure. The main weakness is moderate verbosity - some sections explain things Claude can infer (trigger phrases, 'recommended' labels) and could be condensed. The concrete examples and clear decision trees for different use cases are particular strengths.
Suggestions
Remove or condense the 'When to Use This Skill' section - Claude can infer appropriate triggers from the skill description and content
Eliminate editorial commentary like 'This is the easiest and most common approach' and 'Recommended' labels - let the structure speak for itself
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy (e.g., 'When to Use This Skill' section lists triggers Claude can infer, and some explanations like 'This is the easiest and most common approach' are unnecessary). The content could be tightened by ~20-30%. | 2 / 3 |
Actionability | Excellent actionability with fully executable bash commands, complete script parameters, YAML configuration examples, and copy-paste ready code blocks throughout. Every section provides concrete, runnable examples. | 3 / 3 |
Workflow Clarity | Clear workflow guidance section with explicit decision paths for different use cases (simple demos, batch, interactive, custom). The interactive recording section includes numbered steps with clear completion signal (Ctrl+D). Troubleshooting section provides validation/recovery paths. | 3 / 3 |
Progressive Disclosure | Well-structured with clear overview, appropriately references external files (references/vhs_syntax.md, references/best_practices.md, templates) without deep nesting. The 'Bundled Resources' section provides clear navigation to supporting materials. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.