Back to Blog
tutorialgetting-started

Getting Started with DevRecess

February 15, 20265 min readBy DevRecess Team

DevRecess turns dry technical documentation into narrative-driven play sessions. Instead of reading through pages of API docs, you follow a story — solving problems, making decisions, and learning by doing.

What is a Session?

Each DevRecess session is a single markdown file (SKILL.md) that follows the Anthropic Agent Skills format. Sessions include:

  • A narrative setting — a space station, noir city, fantasy realm, or other immersive world
  • A conflict to resolve — the story-driven problem that teaches you the technology
  • Guided exercises — hands-on coding challenges woven into the narrative
  • Progressive difficulty — from beginner to advanced, clearly marked

How to Use a Session

Step 1: Browse Available Sessions

Visit the DevRecess sessions repository to see all available sessions. Each session is organized by subject and difficulty level.

Step 2: Download the SKILL.md File

Click on any session folder to find its SKILL.md file. You can download it directly or copy the raw content.

Step 3: Load it into Your AI Assistant

Sessions work with any AI assistant that accepts markdown instructions:

  • Claude Code — Install as an Agent Skill in your .claude/skills/ directory
  • Claude.ai — Upload to a Project as a knowledge file
  • ChatGPT — Paste into a custom instruction or conversation
  • Cursor — Add as a project rule or context file

Step 4: Follow the Adventure

Once loaded, your AI assistant becomes your guide through the narrative. It will:

  1. Set the scene and introduce the conflict
  2. Present challenges that teach real technical concepts
  3. Adapt to your skill level and pace
  4. Provide hints when you're stuck

Your First Session

We recommend starting with the Bun Runtime session at beginner difficulty. It introduces you to Bun's fast JavaScript runtime through a space station adventure where you need to optimize the station's systems before a critical deadline.

What's Next?

  • Explore more sessions — We add new sessions every two weeks
  • Request a topic — Open a GitHub issue to suggest a subject you'd like to learn
  • Join the waitlist — Sign up for custom session generation (coming soon)

Happy exploring!

Back to all posts