RO

roadmap-maintainer

Updates and tracks repository roadmap progress.

Install

mkdir -p .claude/skills/roadmap-maintainer && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13554" && unzip -o skill.zip -d .claude/skills/roadmap-maintainer && rm skill.zip

Installs to .claude/skills/roadmap-maintainer

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use when updating, reviewing, prioritizing, or turning ideas into tasks for this repository's ROADMAP.md. Applies to roadmap status markers, dependency-aware ordering, scope clarification, completion criteria, and keeping README.md or CHANGELOG.md aligned with shipped roadmap work.
282 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Intermediate

Key capabilities

  • Update the status of items in `ROADMAP.md`.
  • Prioritize roadmap items based on dependencies.
  • Clarify vague ideas into specific roadmap bullets.
  • Align `README.md` and `CHANGELOG.md` with shipped roadmap work.
  • Break down roadmap items into implementation tasks.

How it works

This skill manages `ROADMAP.md` content by reading the existing file, preserving dependency-aware priority, clarifying items, and updating related documentation upon completion.

Inputs & outputs

You give it
A request to add, revise, prioritize, review, or convert `ROADMAP.md` items into tasks.
You get back
An updated `ROADMAP.md` with status markers, prioritized items, clarified scope, and potentially aligned `README.md` or `CHANGELOG.md`.

When to use roadmap-maintainer

  • Prioritizing development tasks
  • Updating roadmap status
  • Clarifying feature scope

About this skill

Roadmap Maintainer

Use this skill when the user asks to add to, revise, prioritize, review, or turn items from ROADMAP.md into implementation tasks.

Workflow

  1. Read ROADMAP.md before changing roadmap content.
  2. Preserve dependency-aware priority order unless the user asks to reorganize it.
  3. Place new items in the earliest section where their prerequisites are already represented.
  4. Clarify vague ideas into implementation-facing roadmap bullets.
  5. Prefer small, independently shippable items over broad bundled initiatives.
  6. Check for duplicates before adding new items.
  7. Keep wording high level, but include enough scope to avoid later ambiguity.

Status Markers

  • Use [ ] for planned work.
  • Use [~] for work in progress.
  • Use [x] for shipped work.
  • Use [?] for research or decision items.
  • Check completed items off in place instead of moving them to a separate completed section.

Prioritization Rules

Order work to minimize blockers, dependencies, and conflicts:

  1. Privacy, storage, data model, and documentation foundations.
  2. Recording reliability and user feedback.
  3. Transcript correction, dictionaries, and profile primitives.
  4. File workflows, search, import/export, batch jobs, and CLI.
  5. Local and remote post-processing providers.
  6. Advanced transcription and app-aware workflows.
  7. Distribution, updates, onboarding, CI, and operational polish.

If a feature affects privacy, storage, transcript metadata, import/export, CLI, or post-processing, make sure the relevant foundation is already captured before placing the feature later in the roadmap.

Completion Hygiene

When a roadmap item ships:

  • Mark it [x] in ROADMAP.md.
  • Add or update user-facing documentation in README.md when users need to know how to use the behavior.
  • Add a CHANGELOG.md entry for shipped user-facing behavior when appropriate.
  • Prune completed roadmap items only after the shipped behavior is documented.

Task Breakdown Guidance

When turning roadmap items into tasks, include:

  • Prerequisites and dependencies.
  • Suggested implementation order.
  • Acceptance criteria.
  • Privacy/security implications.
  • Documentation and changelog updates.
  • Focused verification steps.

When not to use it

  • When the task is not related to `ROADMAP.md` content.
  • When the user asks to reorganize the dependency-aware priority order without specific instructions.

Limitations

  • This skill is limited to managing the `ROADMAP.md` file.
  • It requires adherence to specific status markers and prioritization rules.
  • It focuses on high-level wording for roadmap items.

How it compares

This skill ensures that roadmap updates are structured, prioritized by dependencies, and linked to documentation, preventing ad-hoc changes that could disrupt project flow.

Compared to similar skills

roadmap-maintainer side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
roadmap-maintainer (this skill)03moNo flagsIntermediate
create-issue14moReviewIntermediate
agency-studio-producer04moNo flagsAdvanced
plans-kanban03moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry