roadmap-generator
Roadmap Generator - Auto-activating skill for Enterprise Workflows. Triggers on: roadmap generator, roadmap generator Part of the Enterprise Workflows skill category.
36
Quality
3%
Does it follow best practices?
Impact
99%
1.01xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./planned-skills/generated/20-enterprise-workflows/roadmap-generator/SKILL.mdQuality
Discovery
7%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 description is severely underdeveloped, essentially providing only the skill name without any substantive information about capabilities or usage triggers. It fails to describe what the skill actually does, uses redundant and limited trigger terms, and provides no guidance for when Claude should select this skill over others.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Creates visual product roadmaps, generates timeline charts, organizes features by priority and release phase, exports roadmap documents'
Expand trigger terms with natural variations users would say: 'product roadmap', 'release timeline', 'feature planning', 'project milestones', 'quarterly planning'
Add an explicit 'Use when...' clause: 'Use when the user needs to plan product releases, visualize project timelines, organize features into phases, or create strategic planning documents'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description only names the skill ('Roadmap Generator') without describing any concrete actions. There are no specific capabilities listed like 'creates timeline visualizations', 'prioritizes features', or 'generates milestone charts'. | 1 / 3 |
Completeness | The description fails to answer 'what does this do' beyond the name itself, and provides no meaningful 'when to use' guidance. The 'Triggers on' section just repeats the skill name rather than providing useful context. | 1 / 3 |
Trigger Term Quality | The trigger terms are redundant ('roadmap generator, roadmap generator') and extremely limited. Missing natural variations users would say like 'product roadmap', 'project timeline', 'release plan', 'feature planning', or 'milestone planning'. | 1 / 3 |
Distinctiveness Conflict Risk | While 'roadmap' is somewhat specific to planning/project management, the lack of detail about what kind of roadmaps or for what purpose means it could conflict with other planning, project management, or visualization skills. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
0%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is an empty template with no substantive content. It describes what a roadmap generator skill might do in abstract terms but provides absolutely no actionable guidance, examples, templates, or workflows for actually generating roadmaps. The content appears to be auto-generated boilerplate that fails every dimension of the rubric.
Suggestions
Add concrete examples of roadmap formats (Gantt charts, timeline views, milestone lists) with actual templates or code to generate them
Define a clear workflow: gather requirements → identify milestones → estimate timelines → generate output format → validate with stakeholders
Include executable code or specific tool commands for generating roadmaps (e.g., Mermaid diagrams, markdown tables, or integration with project management tools)
Remove all generic boilerplate text and replace with specific, actionable instructions that teach Claude how to create roadmaps
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is padded with generic boilerplate that provides no actual value. Phrases like 'provides automated assistance' and 'follows industry best practices' are vague filler that Claude doesn't need explained. | 1 / 3 |
Actionability | There is zero concrete guidance, no code examples, no specific commands, and no actual instructions on how to generate a roadmap. The content describes what the skill supposedly does without showing how to do anything. | 1 / 3 |
Workflow Clarity | No workflow is defined whatsoever. The skill claims to provide 'step-by-step guidance' but contains no actual steps, sequences, or processes for roadmap generation. | 1 / 3 |
Progressive Disclosure | The content is a monolithic block of placeholder text with no references to detailed materials, no links to examples, templates, or supporting documentation that would be essential for a roadmap generator. | 1 / 3 |
Total | 4 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
0c08951
- 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.