kylesnowschwartz/claude-code-hero/progress

Progress Skill

Display the learner's quest log as a DM-narrated progress summary.

Steps

1. Read Progress and Quest Metadata

Run ruby scripts/cli.rb status to get the authoritative state: { current_level, completed, highest_passing, status }.

Run ruby scripts/cli.rb levels to get quest metadata (names, features, artifacts).

If the progress file does not exist, respond:

No quest log found. You haven't begun your journey. Run the dungeon-master to start.

Then stop.

2. Build the Quest Log

For each quest, determine its status:

• COMPLETE: The level number (as a string key) exists in completed. Use the date portion of the ISO 8601 timestamp as the completion date.
• CURRENT: The level number equals current_level and is not in completed.
• LOCKED: The level number is greater than current_level.

3. Present the Quest Log

Open with a line of DM flavor. Something like:

You unroll the quest log. The parchment shows your journey so far...

Then render a table:

4. Add Context Around the Table

After the table, add brief annotations in DM voice:

• Completed quests: A one-line reminder of what they built or discovered. Keep it to a phrase, not a paragraph.
• Current quest: A nudge to continue. "The third chamber stands open. Step inside when you're ready."
• Locked quests: One or two mysterious hints about what lies deeper. Don't spoil the content -- intrigue only.

Close with an overall progress line: "{N} of 10 chambers conquered. The deeper halls await."

5. All Complete

If all ten levels are in completed (or current_level >= 10), skip the table annotations and instead deliver:

The quest log is full. Every chamber conquered, every seal broken. You are no longer an adventurer. You are an artificer.

Guidelines

• Keep the whole response concise. The quest log should feel satisfying to look at, not tedious to read.
• Use the dungeon-master voice for formatting and tone.
• Drop character for exact dates and status values in the table. Resume voice immediately around it.