Claude Buddy Card

Generate a deterministic holographic trading card from a Claude Code Buddy identity.

13|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/dyz2102/buddy-card --skill claude-buddy-card
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Claude Buddy Card
Source: https://github.com/dyz2102/buddy-card/tree/main
Command: npx skills add https://github.com/dyz2102/buddy-card --skill claude-buddy-card

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill turns the hidden “Buddy” identity behind Claude Code into a polished, shareable trading card you can generate on demand.

Core Features & Use Cases

  • Unique Buddy generation: Computes Buddy species, rarity, eyes, hat, shiny variant, stats, and a card number deterministically from your Claude account UUID.
  • Holographic card creation: Uses Google (Gemini) image generation to render a premium card at 3:4 aspect ratio with style varying per regeneration.
  • Mac Keychain identity lookup: Reads your Claude OAuth token from local macOS Keychain, then fetches your account UUID to ensure “same person = same Buddy”.
  • Use case: Great for users who want a fun, deterministic collectible artwork tied to their identity, with stats preserved while art can be regenerated.

Quick Start

Ask: /buddy-card to generate your holographic Claude Buddy trading card and save it to your Downloads folder.

Frequently Asked Questions about Claude Buddy Card

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

FAQPage Schema
How do I generate a deterministic trading card from my Claude Code account?

To generate a deterministic trading card, this Skill reads your Claude OAuth token from macOS Keychain to fetch your account UUID, computes Buddy details via FNV-1a and Mulberry32 algorithms, and renders a holographic image using Google Gemini.

Do I need macOS Keychain access to generate my Claude Buddy identity?

Yes, macOS Keychain access is required to obtain your Claude OAuth token, which is used to fetch your account UUID and ensure same person equals same Buddy.

Can I regenerate the trading card artwork while keeping my Buddy stats stable?

Yes, you can regenerate the holographic artwork while keeping species, rarity, stats, and card number stable, allowing style variations per regeneration without changing your Buddy identity.

What API key is needed for Google Gemini image generation in this workflow?

You need a GOOGLE_API_KEY or GEMINI_API_KEY to call Google Gemini image generation for rendering the final 3:4 aspect ratio holographic card.

How does deterministic identity generation work for Claude Code users?

Deterministic identity generation works by computing Buddy species, rarity, eyes, hat, shiny variant, stats, and a card number directly from your Claude account UUID using FNV-1a and Mulberry32 algorithms.

What are the limitations of generating Claude Buddy cards on non-macOS systems?

The main limitation is that this Skill requires macOS Keychain to read your Claude OAuth token, meaning users on non-macOS systems cannot fetch their account UUID to generate their Buddy card.