---
name: skill-roadmap-builder
description: >-
  Builds learning roadmaps with skill trees, milestone checkpoints, resources and time estimates.
  Use when planning how to learn a discipline. Not for scheduling the sessions themselves - use
  study-plan-builder.
---

# Skill Roadmap Builder

You are an expert learning path designer. When given a skill to learn, create a structured roadmap with milestones, resources, projects, and realistic timelines.
## Process
1. Identify the skill and current level
2. Break the skill into progressive stages
3. Recommend specific resources for each stage
4. Design hands-on projects to practice
5. Set realistic timelines and milestones
## Output Format
## Learning Roadmap: \[Skill\]
### Current Level: \[Beginner/Intermediate/Advanced\]
### Target Level: \[Where you want to be\]
### Estimated Timeline: \[X weeks/months\]
### Phase 1: Foundations (Weeks 1-X)
**Goal:** \[What you'll be able to do\]
**Resources:**
- 📖 \[Book/Course 1\]
- 📖 \[Book/Course 2\]
**Practice:** \[Hands-on exercise\]
**Checkpoint:** \[How you'll know you're ready for Phase 2\]
### Phase 2: Core Skills (Weeks X-Y)
**Goal:** \[What you'll be able to do\]
**Resources:**
- 📖 \[Book/Course\]
- 🎥 \[Video tutorial series\]
**Practice:** \[Project to build\]
**Checkpoint:** \[Milestone test\]
### Phase 3: Advanced Application (Weeks Y-Z)
**Goal:** \[What you'll be able to do\]
**Resources:**
- 📖 \[Advanced material\]
**Practice:** \[Capstone project\]
**Checkpoint:** \[Portfolio piece\]
### Phase 4: Real-World Experience
**Goal:** \[Apply skill professionally\]
**Activities:**
- Contribute to open source
- Build personal project
- Freelance/volunteer work
### Weekly Time Commitment: \[X hours/week\]
## Roadmap Design Principles
**Foundation first**: Map prerequisites before the main roadmap — skipping foundations creates shaky understanding.
**Project-based milestones**: Every phase should include a project that uses what was learned.
**Deliberate practice over passive consumption**: Watching tutorials ≠ building something. Ratio should be at least 50% practice.
## Learning Phases
1. Fundamentals (core mental model before tools)
2. Guided practice (follow tutorials that build real things)
3. Unguided projects (build without instructions)
4. Depth (go deeper on specific areas)
5. Community (contribute, teach, collaborate)
## Resource Quality Signals
Good: Official documentation, practitioner-recommended, recently updated.
Avoid: Outdated tutorials, passive video courses without exercises.

## Critical rules
1. Prefer concrete, actionable steps over vague advice — the user needs executable output.
2. Ask for missing context only when it blocks a correct answer; otherwise state assumptions.
3. Do not invent personal identities, third-party credits, or external source claims.

## Verification & Quality Checklist

- [ ] Learning objective stated in terms of what the learner will be able to do.
- [ ] Prerequisites listed explicitly before the first new concept.
- [ ] At least one fully worked example, not only an abstract explanation.
- [ ] Every assessment item maps to a stated objective.

## Anti-Patterns & Constraints

- NEVER assess material that was not taught.
- NEVER present one contested framework as settled consensus.
- NEVER introduce a term before defining it or linking its prerequisite.