Structured Learning Skill
// how it works
An AI-powered, project-based learning engine for mastering any technology or framework by building a resume-strong Capstone Project through gamified Micro-Tasks and an interactive 9-Step Learning Cycle.
Overview
The Structured Learning Framework transforms passive reading into deep, resume-building mastery. Acting as a dedicated AI Teacher-Agent & Game Master, it helps you brainstorm or select a top-tier Capstone Project, maps out project milestones (Frontend, Backend, Operations), breaks topics into 15-30 minute micro-task quests for continuous dopamine hits, awards XP & Badges, and enforces active recall.
Gamification Engine
- Bite-Sized Micro-Task Quests: Challenges are split into 15-30 min micro-tasks (
Quest 1,Quest 2) for fast wins and high motivation. - XP & Level Progression: Earn XP for WIUs (+50 XP), Quests (+50 XP), Challenges (+100 XP), BREAK IT (+50 XP), and Milestones (+300 XP). Advance from Novice Explorer to Senior Master Architect.
- Unlockable Achievements: Badges like ️ Foundation Architect, Backend Mastermind, UI Wizard, ️ Bug Hunter, Chaos Monkey, and Production Titan.
- Gamified Progress Dashboard: Live XP progress bar
[████████░░], active streak tracker, unlocked badges matrix, and milestone checklist incoursework/progress.md.
The 9-Step Learning Cycle
flowchart LR
A["1. LEARN"] --> B["2. ANSWER (+50 XP)"]
B --> C["3. REVIEW"]
C --> D["4. APPLY / QUESTS (+100 XP)"]
D --> E["5. VERIFY"]
E --> F["6. REVISE"]
F --> G["7. BREAK IT (+50 XP)"]
G --> H["8. ERROR LOG (+25 XP)"]
H --> I["9. RECALL"]
| Step | Action | Description | Gamification |
|---|---|---|---|
| 1️⃣ LEARN | Read Core Concepts | Study curated docs, architectural guides, and examples. | — |
| 2️⃣ ANSWER | Write WIU File | Explain concepts in your own words & log doubts (What I Understand). | +50 XP |
| 3️⃣ REVIEW | AI Assessment | Teacher-agent corrects misconceptions & resolves doubts. | — |
| 4️⃣ APPLY | Micro-Task Quests | Solve bite-sized hands-on quests under time-boxed constraints. | +50 XP / Quest |
| 5️⃣ VERIFY | Code Review | Agent evaluates logic, edge cases, and code quality. | — |
| 6️⃣ REVISE | Refine & Refactor | Implement feedback and document changes made. | — |
| 7️⃣ BREAK IT | Stress Test | Intentionally break code on a dev branch to observe failure modes. | +50 XP |
| 8️⃣ ERROR LOG | Track Root Causes | Record mistakes & underlying patterns in error_journal.md. |
+25 XP |
| 9️⃣ RECALL | Spaced Repetition | Re-answer self-assessments from memory before the next sitting. | — |
[!IMPORTANT] Post-Project Milestone: After completing all sittings and building your Capstone Project, face a 20-question rapid-fire Teach-Back Interview & Resume Pitch to prove complete mastery without notes.
Key Capabilities
- Capstone Project Brainstorming & Selection: Brainstorms with you at setup or proposes resume-strong project concepts engineered to impress hiring managers.
- Milestone Roadmap: Maps coursework directly across Frontend, Backend, Operations, Auth, and Live Deployment.
- Continuous Dopamine Loop: Small, micro-task quest breakdown prevents fatigue and keeps engagement high.
- Automatic Roadmap Ingestion: Scrapes platforms like roadmap.sh or GitHub repositories to build accurate curricula.
- Phased Incremental Generation: Delivers topic files one at a time to maintain high detail, avoid context limits, and adapt to your pace.
- Socratic Teacher & Game Master Mode: Guides and hints rather than giving away answers, awarding XP and badges on approved submissions.
Coursework Directory Layout
├── learning_path.md # Master syllabus with Capstone Blueprint, Milestones & Gamification rules
├── README.md # Framework documentation
└── coursework/
├── progress.md # Gamified Progress Dashboard (Level, XP Bar, Badges, Milestones)
├── error_journal.md # Running log of mistakes, misconceptions & root causes
├── sitting_1/
│ ├── topic_1_1.md # Topic content, concepts & Micro-Task Quests prompt
│ ├── what_i_understand/
│ │ └── wiu_topic_1.1.md # Student WIU response
│ └── exercises/
│ └── challenge_1.js # Micro-task quest submission & automated test suite
└── sitting_2/ # Generated incrementally upon Sitting 1 completion
Quick Start / How to Use
Simply trigger the skill in your conversation:
Explicit Triggers
"Create a learning path for Next.js 14 App Router"
"Teach me Docker and Kubernetes basics with a Capstone Project"
"Help me build a resume-strong project while learning Rust"
️ Repository Resources
- SKILL.md — Main prompt definition, Capstone rules & Gamification engine
- references/curriculum_structure.md — Syllabus template & Capstone Blueprint format
- references/folder_structure.md — Gamified Progress Dashboard template & Error Journal
- references/teaching_rules.md — Pedagogical feedback, XP calculations & Badge rules
- references/topic_template.md — Topic structure & Micro-Task Quest layout