Progress Skill

SkillMonitoring & ops

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

Available today. Use it from your connected AI after setup.

No other account needed.

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

Then ask your AI: use the Progress Skill skill

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.

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.

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.

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:

Quest	Name	Status	Completed
0	The Threshold	COMPLETE	2026-03-27
1	The Map Room	COMPLETE	2026-03-27
2	The Tome of First Instructions	COMPLETE	2026-03-27
3	The Goblin Lair of Commands	CURRENT	--
4	The Warden's Keys	LOCKED	--
...	...	...	...

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."

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.

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.

Advanced