vibe-check

Analyze a codebase to generate a D&D-style character sheet with ASCII art and stats.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/srcfl/vibe-check --skill vibe-check-srcfl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vibe-check
Source: https://github.com/srcfl/vibe-check/tree/main
Command: npx skills add https://github.com/srcfl/vibe-check --skill vibe-check-srcfl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes a codebase and translates its personality into a D&D character sheet, including ASCII art, stats, and witty commentary to help teams understand their repo at a glance.

Core Features & Use Cases

  • Analyzes commits, code patterns, dependencies, and file structure to produce a compact, shareable character sheet.
  • Outputs both a terminal-friendly report and a printable HTML card for sharing.
  • Auto-detects language and adapts patterns to the repository, with a tongue-in-cheek, constructive tone.

Quick Start

Run vibe-check on a repository to generate a D&D-style character sheet.

Frequently Asked Questions about vibe-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a codebase to generate a D&D character sheet?

To analyze a codebase and generate a D&D character sheet, run vibe-check on your repository. It collects commit history, code patterns, dependencies, and file structure to produce a character sheet capturing your repo's personality.

Can I generate a shareable HTML card from my repository metrics?

Yes, you can generate a shareable HTML card from repository metrics. The analysis produces both a terminal-friendly ASCII character sheet and a printable HTML card for sharing your codebase stats.

Does the code analysis support multi-language projects?

Yes, the code analysis supports multi-language projects. It auto-detects the programming language and adapts its pattern detection to the repository to accurately score and map the codebase personality.

What code metrics are used to determine the codebase personality?

Codebase personality is determined by analyzing commits, code patterns, dependencies, and file structure. These repository metrics are processed end-to-end to generate stats, ASCII creatures, and witty commentary.

How do I get a terminal-friendly report of my repository's stats?

You get a terminal-friendly report by running the analysis on your repository. It outputs a compact ASCII character sheet directly in the CLI, delivering stats and artifact listings with safety and validation.