roadmap-init

Generate a macro ROADMAP.md with M0–M8 milestones and clone SOTA reference repositories.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill roadmap-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roadmap-init
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/roadmap-init
Command: npx skills add https://github.com/usetheodev/theo-ui --skill roadmap-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstrap a structured project inception by generating a macro ROADMAP.md and assembling a curated set of SOTA references, ensuring auditable planning inputs.

Core Features & Use Cases

  • Generates ROADMAP.md with milestones M0–M8 and a references section.
  • Clones shallowly a curated set of SOTA reference repositories into knowledge-base/references/.
  • Persists Socratic interview results (grill) for resumability and auditing.

Quick Start

Invoke /roadmap-init {topic-slug} to bootstrap a macro ROADMAP.md and a curated reference set.

Frequently Asked Questions about roadmap-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap a project roadmap with SOTA references?

To bootstrap a project roadmap with SOTA references, the skill generates a macro ROADMAP.md and shallow-clones state-of-the-art peer repositories into a local knowledge base for auditable study.

How does the Socratic interview work for project inception?

The Socratic interview for project inception works by guiding you through 7 structured questions, persisting the transcript to ensure resumability and providing auditable inputs for milestone generation.

What is the best way to structure milestones M0 through M8?

The best way to structure milestones M0 through M8 is by automating macro roadmap generation, which outputs a structured ROADMAP.md file directly populated with these defined project phases.

Does the cloning process gate repositories by license?

Yes, the cloning process gates repositories by license. It performs web searches for SOTA peers, filters them based on license compatibility, and only shallow-clones approved repositories.

Can I generate a machine-readable references catalog for downstream tasks?

Yes, you can generate a machine-readable references catalog for downstream tasks. The skill creates this catalog alongside the ROADMAP.md to enable subsequent automated analysis and processing.

What are the limitations of shallow-cloning SOTA peers for project inception?

A limitation of shallow-cloning SOTA peers for project inception is that it fetches only the latest surface-level repository state, meaning deep historical context or detached commits are excluded from the references.