/vibe-check

A Claude Code skill that analyzes your codebase's personality and generates a D&D character sheet.

It scans your git history, code patterns, dependencies, and file structure, then roasts your repo as a fantasy adventurer. Complete with ability scores, loot, vulnerabilities, and an ASCII creature.

Install

Copy the skill into your Claude Code config:

Personal (all projects):

mkdir -p ~/.claude/skills/vibe-check
curl -o ~/.claude/skills/vibe-check/SKILL.md \
  https://raw.githubusercontent.com/srcfl/vibe-check/main/SKILL.md

Project (shared with team):

mkdir -p .claude/skills/vibe-check
curl -o .claude/skills/vibe-check/SKILL.md \
  https://raw.githubusercontent.com/srcfl/vibe-check/main/SKILL.md

Usage

In Claude Code, type:

/vibe-check

That's it. It will:

1. Scan your repo's git history, code patterns, and dependencies
2. Generate a D&D character sheet in your terminal
3. Save a styled HTML card to ./vibe-check-result.html for sharing on social media

Focus on a specific area

/vibe-check src/api

What it analyzes

Signal	What it checks
Commits	Message style, frequency, contributors, best/worst messages
Code sins	TODOs, debug prints, type bypasses, linter disables, empty catches
Code virtues	Type strictness, test files, clean patterns
Dependencies	Count, production vs dev, notable/funny packages
File structure	Largest files (god files), total size, churn
Git archaeology	Most edited files, oldest surviving code

What it outputs

A full D&D character sheet with:

• Class (Barbarian, Warlock, Paladin, Rogue, etc.) based on code patterns
• Ability scores (STR, DEX, CON, INT, WIS, CHA) mapped to real metrics
• HP and AC calculated from commits, files, and test coverage
• ASCII creature unique to your repo's personality
• Proficiencies (what your repo is good at)
• Vulnerabilities (what it's bad at, lovingly roasted)
• Notable loot (dependencies described as D&D items)
• Quest log (real commit messages, picked for humor)
• Known haunts (most edited files as dungeon locations)
• Party members (contributors and their commit counts)

Language support

Works on any repo. Auto-detects:

• TypeScript / JavaScript
• Python
• Rust
• Go
• And more (adapts patterns to whatever it finds)

Share your results

The skill generates a styled HTML card at ./vibe-check-result.html. Open it in your browser, screenshot it, and post it.

Tag us: @sourcaboreal

License

MIT

---

Built by Sourceful Energy. We build local energy coordination infrastructure, not just Claude Code skills. But sometimes you need to vibe-check a repo.