Name: roadmap-communicator
Rating: 67.2 (1 reviews)
Author: alirezarezvani

roadmap-communicator

Use when preparing roadmap narratives, release notes, changelogs, or stakeholder updates tailored for executives, engineering teams, and customers.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

The canonical home for this skill is roadmap-communicator in alirezarezvani/claude-skills

Quality

Content

78%Weight 40%Scale 1-5

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

The body is lean and well-organized with concrete patterns and a useful checklist, scoring well on conciseness and workflow clarity. Its main weakness is progressive disclosure: every referenced bundle file (references/roadmap-templates.md, references/communication-templates.md, scripts/changelog_generator.py) is missing, so signaled navigation leads nowhere.

Suggestions

Create the referenced bundle files (references/roadmap-templates.md, references/communication-templates.md, scripts/changelog_generator.py) so the signaled navigation resolves to real content.

Either implement scripts/changelog_generator.py as an executable script or replace the command example with concrete inline guidance so the changelog-generation step is genuinely runnable.

Add a brief validation or sanity-check step after changelog generation (e.g., confirm the output groups match conventional commit prefixes) to strengthen the workflow's feedback loop.

Dimension	Reasoning	Score
Conciseness	Terse bullet lists throughout, no over-explanation of concepts Claude already knows, and every section earns its place, matching the 'lean and efficient; every token earns its place' anchor.	5 / 5
Actionability	Provides a concrete changelog command, a numbered feature framework, specific patterns, and a checklist, but the one executable command references scripts/changelog_generator.py which does not exist, a concrete gap fitting 'mostly executable guidance; minor gaps'.	4 / 5
Workflow Clarity	The feature announcement framework is a clear numbered sequence and the quality checklist serves as an explicit validation gate; no destructive or batch operations require validate-retry loops, fitting 'clear sequence with most checkpoints present; minor validation gaps'.	4 / 5
Progressive Disclosure	Section structure is good and references are clearly signaled ('See references/roadmap-templates.md for templates'), but the referenced files and scripts/ do not exist, so navigation is signaled but broken, fitting the 'some structure; references present but undermined' level rather than 4.	3 / 5
	Total	16 / 20 Passed

Description

83%Weight 40%Scale 1-5

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

The description is well-constructed with an explicit 'Use when' trigger and concrete artifact types, clearly answering both what and when. Minor gaps in action-verb diversity and synonym coverage keep specificity and trigger-term quality at 4 rather than 5.

Dimension	Reasoning	Score
Specificity	Lists four concrete artifact types (roadmap narratives, release notes, changelogs, stakeholder updates) and three audiences, but uses a single action verb ('preparing') rather than multiple distinct verbs, fitting the 'several specific actions with minor gaps' anchor.	4 / 5
Completeness	Explicitly answers both what (preparing the listed artifacts) and when (the 'Use when...' clause) with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Strong natural keywords users would say ('release notes', 'changelogs', 'roadmap', 'stakeholder updates'), but missing common synonyms such as 'what's new' or 'version notes', fitting the 'good keyword coverage, a few natural terms missing' anchor.	4 / 5
Distinctiveness Conflict Risk	The roadmap/stakeholder-communication niche is distinctive, but release notes and changelogs could overlap with a dedicated git-changelog skill, fitting 'mostly distinct; minor overlap risk'.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 3 missing	Warning

	Total	15 / 16 Passed

Repository: alirezarezvani/claude-skills
Path: .gemini/skills/roadmap-communicator/SKILL.md
Commit: 19392f7

Reviewed: ~3 hours ago

Table of Contents

Discovery Implementation Validation

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.