progress - SKILL.md Agent Skill

name: progress description: "This skill should be used when the user types /progress, asks 'how am I doing', 'show my progress', 'how many lessons have I completed', 'what percentage am I through', 'what's my streak', or wants a curriculum progress overview." version: 1.0.0

/progress — Progress Dashboard

Display a comprehensive visual progress report for the student's learning journey.

Workflow

Step 1: Read Progress Data

Read learning/progress/current-state.md.

Extract all fields: phase, phase_name, lesson, lesson_name, completed_count, remaining_count, start_date, last_activity, current_streak_days, skills_unlocked.

Step 2: Calculate Progress

Overall percentage: pct = round((completed_count / 64) * 100)

Phase boundaries (cumulative):

Phase	Lessons	Cumulative End
0	6	6
1	9	15
2	8	23
3	9	32
4	7	39
5	7	46
6	8	54
7	5	59
8	5	64

For each phase, calculate how many lessons are done based on completed_count vs the cumulative boundaries.

Step 3: Generate ASCII Progress Bars

Overall bar (20-character width):

filled = round(pct / 5)
bar = "=" * filled + "-" * (20 - filled)
Display: [{bar}] {pct}% Complete

Per-phase bars (10-character width):

phase_pct = (phase_completed / phase_total) * 100
filled = round(phase_pct / 10)
bar = "=" * filled + "-" * (10 - filled)

Step 4: Display the Dashboard

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ZERO TO PORTFOLIO — PROGRESS DASHBOARD
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Overall Progress
  [--------------------] 0% Complete
  0 of 64 lessons complete

  Current Position
  📍 Phase 0: Getting Started
     Lesson 1: What Is a Computer?

  ─────────────────────────────────────────────
  Phase Breakdown
  ─────────────────────────────────────────────

  Phase 0: Getting Started      [----------] 0/6
  Phase 1: Web Fundamentals     [----------] 0/9
  Phase 2: JavaScript           [----------] 0/8
  Phase 3: React                [----------] 0/9
  Phase 4: Astro                [----------] 0/7
  Phase 5: Tailwind CSS         [----------] 0/7
  Phase 6: Portfolio            [----------] 0/8
  Phase 7: Git & GitHub         [----------] 0/5
  Phase 8: Deployment           [----------] 0/5

  ─────────────────────────────────────────────
  Stats
  ─────────────────────────────────────────────

  🔥 Current Streak: 0 day(s)
  📅 Started: {start_date}
  📅 Last Activity: {last_activity}

  🏆 Skills Unlocked
  None yet — keep going!

  ─────────────────────────────────────────────
  Next Milestone
  ─────────────────────────────────────────────

  Complete 6 more lessons to finish Phase 0!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Fill in actual values from current-state.md. Mark completed phases with ✅.

Step 5: Milestone Celebrations

If completed_count exactly equals a phase boundary (6, 15, 23, 32, 39, 46, 54, 59, 64):

Add a celebration message below the dashboard

If completed_count == 64:

Full graduation message: "🎓 YOU DID IT! You've completed all 64 lessons! Time to deploy your portfolio!"

Step 6: Motivational Close

End with an encouraging one-liner referencing their current position.