Questly

Your GitHub issues, reimagined as an RPG quest board.

A Claude Code skill — no API key, no install, no config.

---

What it does

Type /questly in any Claude Code session. Questly reads your repo's real open issues, file structure, and languages, then generates 6 tailored quests for you to actually complete — ranked by difficulty, written in dungeon-master voice, grounded in your actual code.

╔══════════════════════════════════════════════════╗
║  ♦  LEGENDARY  ♦                           [6]  ║
║                                                  ║
║  Slay the Auth Dragon                            ║
║  ────────────────────────────────────────────    ║
║  Ancient magic guards the gates, but its         ║
║  runes were written before the great update.     ║
║                                                  ║
║  Refactor src/auth/provider.py to replace        ║
║  the deprecated OAuth1 flow with PKCE,           ║
║  tracked in issue #47.                           ║
║                                                  ║
║  Reward: 1000 XP                                 ║
╚══════════════════════════════════════════════════╝

Accept a quest, do the work, then say verify 6 — Claude judges whether you actually completed it.

---

Setup

Option A — this project only:

git clone https://github.com/KiernanJ/questly
cd questly

Open Claude Code here and type /questly.

Option B — every project on your machine:

mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/questly.md \
  https://raw.githubusercontent.com/KiernanJ/questly/main/.claude/commands/questly.md

Then /questly works anywhere.

---

How it works

Questly is a single markdown file (.claude/commands/questly.md) that acts as a Claude Code slash command. When you invoke it:

1. It runs gh/curl to fetch your repo's open issues, file tree, languages, and metadata
2. Claude generates 6 quests tied to what it finds — real file names, real issue numbers
3. The quest board renders in your terminal with Unicode box-drawing characters
4. Accept and verify quests conversationally in the same session

No separate process. No API key. Claude Code is the runtime.

Tier	Icon	XP	What to expect
Common	·	100	Small, self-contained tasks
Rare	✦	250	Meaningful refactors or features
Epic	★	500	Architectural improvements
Legendary	♦	1000	The thing you've been putting off

---

Contributing

• install.sh one-liner for global setup
• Export accepted quests as GitHub issues
• GitLab / Bitbucket support
• Party mode — shared board across a team

PRs welcome.

---

_{Built with Claude Code · MIT License}