Cheaters Generator

Generate personalized Claude Code cheatsheet systems inspired by Brett Terpstra's Cheaters.

What It Does

Creates a local HTML-based quick-reference system customized to YOUR Claude Code setup:

• Dark & light themes with system preference detection
• Global search - Press / to search all commands across sheets
• Keyboard navigation - j/k, arrows, Enter to select
• Sheets for everything - Claude commands, custom skills, plugin packs, MCP servers
• Auto-discovery - Scans your actual configuration to build relevant sheets
• Example prompts - Pulls demonstration phrases from MCP server READMEs
• LocalStorage persistence - Remembers your last-viewed sheet and theme

Installation

Option 1: Plugin Install (Recommended)

# Add the marketplace
claude plugin marketplace add aplaceforallmystuff/cheaters-generator

# Install the plugin
claude plugin install cheaters-generator

Start a new Claude Code session to use the commands and skills.

Option 2: Manual Install

# Clone the repo
git clone https://github.com/aplaceforallmystuff/cheaters-generator.git
cd cheaters-generator

# Install commands
cp -r commands/* ~/.claude/commands/

# Install skills
cp -r skills/* ~/.claude/skills/

Usage

Generate Your Cheatsheet

/generate-cheaters

Or with a custom location:

/generate-cheaters ~/Documents/my-cheaters

What Gets Scanned

The skill automatically discovers:

Source	Command
MCP Servers	claude mcp list
Custom Skills	ls ~/.claude/skills/
Slash Commands	ls ~/.claude/commands/
Custom Agents	ls ~/.claude/agents/
Installed Plugins	ls ~/.claude/plugins/marketplaces/

Using Your Cheatsheet

After generation, open the cheatsheet in your browser:

# Open directly in browser (replace with your output location)
open /path/to/your-cheaters/index.html

# Or serve locally (for live editing)
cd /path/to/your-cheaters && python3 -m http.server 8888
# Then visit http://localhost:8888

Keyboard Shortcuts

Key	Action
/	Focus search
Esc	Close search
↑ / ↓	Navigate results / sheets
Enter	Select result
k / j	Previous / next sheet

What's Included

Skills

Skill	Description
cheaters-generator	Main skill for generating personalized cheatsheets

Commands

Command	Description
/generate-cheaters	Generate a cheatsheet at specified location

Modular Architecture

The cheatsheet uses a modular sheet architecture for easy maintenance:

your-cheaters/
├── index.html              # Main HTML with navigation
├── stylesheets/
│   └── main.css            # Themes and styling
├── javascripts/
│   └── main.js             # AUTO-GENERATED - do not edit directly
└── sheets/                 # Individual sheet files (2-12 KB each)
    ├── claude-commands.html
    ├── custom-skills.html
    ├── custom-agents.html
    ├── mcp-*.html          # One per MCP server
    └── ...

Editing Sheets

Edit individual files in sheets/ - each is small and self-contained:

# Edit a specific sheet
vim sheets/custom-agents.html

Each sheet has metadata at the top:

<!-- meta: {"updatedAt": "2025-12-07T10:00:00", "hasNew": true} -->
<div class="sheet">
    ...
</div>

Build Process

After editing sheets, rebuild main.js:

# From the cheaters-generator directory
node scripts/build.js /path/to/your-cheaters

# Or use the default output location
node scripts/build.js

Migration Script

Upgrading from monolithic main.js to modular sheets:

node scripts/extract-sheets.js /path/to/your-cheaters

This extracts existing sheets into individual files.

Customization

The generated cheatsheet is pure HTML/CSS/JS. Edit:

• sheets/*.html - Individual sheet content (recommended)
• index.html - Add/remove navigation items
• stylesheets/main.css - Customize colors and layout
• javascripts/main.js - AUTO-GENERATED from sheets (don't edit directly)

CSS Variables

:root {
    --bg-dark: #1a1a2e;
    --bg-sidebar: #16213e;
    --bg-content: #0f0f1a;
    --accent: #8b5cf6;      /* Purple accent */
    --success: #22c55e;      /* Green for plugins */
    --warning: #f59e0b;      /* Orange for MCP */
    --info: #3b82f6;         /* Blue for built-in */
}

Tag Classes

• .tag-builtin - Blue, for Claude built-in commands
• .tag-custom - Purple, for user skills
• .tag-agent - Pink, for custom subagents
• .tag-plugin - Green, for plugin packs
• .tag-mcp - Orange, for MCP servers

Example Output

The generated cheatsheet includes:

Core Section

• Claude Commands (built-in commands, keyboard shortcuts)
• Custom Skills (your ~/.claude/skills/)
• Custom Agents (your ~/.claude/agents/) - grouped by domain

Plugin Packs Section

• One sheet per installed plugin with all commands/skills

MCP Servers Section

• One sheet per MCP server with:
  • Example prompts (natural language queries)
  • Tools grouped by category
  • Parameter documentation

Contributing

1. Fork the repo
2. Create a feature branch
3. Submit a PR

License

MIT

Author

Jim Christian - hello@jimchristian.net