Progress Skill

SkillMonitoring & ops

Claude Code Hero progress report -- shows the learner's quest log with completed, current, and locked quests

Use Progress Skill in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Progress Skill and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Progress Skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Progress SkillStart free

What this skill tells your AI

The instructions your AI receives, as published by kylesnowschwartz/claude-code-hero in skills/progress/SKILL.md and read by Ahel’s review.

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:

QuestNameStatusCompleted
0The ThresholdCOMPLETE2026-03-27
1The Map RoomCOMPLETE2026-03-27
2The Tome of First InstructionsCOMPLETE2026-03-27
3The Goblin Lair of CommandsCURRENT--
4The Warden's KeysLOCKED--
............

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.

Signals

GitHub stars
102
Forks
6
Last commit
Sep 2026
Advanced
Item type
skill
Key
progress-kylesnowschwartz
Source
github.com/kylesnowschwartz/claude-code-hero