🫘 SpillBeans

Your Developer Soulmate & Social Media Growth Expert for Building in Public.
Turn raw AI agent chaos, midnight thoughts, and hard-fought bug victories into viral X (Twitter) visual cards & authentic LinkedIn founder stories.

---

💡 What Makes SpillBeans Unique?

Most build-in-public tools just dump boring git logs or dry status updates. SpillBeans works like a social media marketing expert who knows you like a soulmate.

Capy-Dev (your mascot & co-pilot) looks beyond raw code diffs to read between the lines:

• It knows your silent frustrations: Spending 3 hours on a single race condition or fighting an AI agent's hallucination.
• It knows your inner monologue: Asking yourself if your architecture is brilliant or totally over-engineered at 1:30 AM.
• Dual-Platform Architecture (X & LinkedIn):
  • 🐦 X (Twitter): Formats your posts into high-converting 1-to-4 visual text cards (1:1 square) with dramatic conflict hook covers.
  • 💼 LinkedIn: Formats your posts into compelling personal founder stories with strict 3-line "above-the-fold" hooks and 16:9 feature visual banners with value-pill badges.
  • 🚀 Cross-Post Bundle: Generates tailored copy and visuals for both platforms in one run.
• Clean Metadata Hygiene: Automatically strips C2PA/EXIF metadata so platform uploaders won't flag graphics with unwanted AI badges.
• It speaks your language automatically: Seamlessly adapts to any language specified by the user.

"The best build-in-public content isn't polished marketing copy. It's spilling the beans on your real thoughts, pain points, and breakthroughs in scannable, attention-grabbing visual formats."

---

✨ Features

• 🦫 Dev Soulmate Persona: Hyper-perceptive tone that understands developer psychology, imposter syndrome, and the thrill of a green test suite.
• 🐦 X (Twitter) Visual Text Cards: Uses Twitter's 4-image grid with clean, typo-free typography (< 25 words/card) and dramatic cover cards.
• 💼 LinkedIn Founder Story Mode: Long-form authentic storytelling with high-stakes 3-line hooks, emotional tension, and tangible real-world transformation.
• 🎨 16:9 Feature Banners: Generates high-impact 16:9 visual banners featuring Capy-Dev with project branding and 3 value-pill badges.
• 🌐 Auto Multi-Lingual Support: Automatically detects the user's language and generates all topics, titles, story copy, and visual card prompts accordingly.
• 🤖 Universal Agent Support: Fully compatible with Google Antigravity, Claude Code, and OpenAI Codex workflows.
• 🚀 Zero-Setup Workflow: No OAuth tokens, no APIs, and no local script configurations. Works entirely in-session for copy-paste velocity.

---

🚀 Installation

You can install spill-beans using plugin managers or manually download the skill file:

1. Claude Code

• As a Plugin (Recommended): Register the registry and install:

  /plugin marketplace add tianchengc/spill-beans
  /plugin install spill-beans@spill-beans

• Manual Skill Download: Run this in your terminal to fetch the skill file directly:

  mkdir -p ~/.claude/skills/spill-beans
  curl -fsSL https://raw.githubusercontent.com/tianchengc/spill-beans/main/skills/spill-beans/SKILL.md -o ~/.claude/skills/spill-beans/SKILL.md

2. Codex

• As a Plugin (Recommended): Register the registry and install:

  codex plugin marketplace add tianchengc/spill-beans
  codex plugin install spill-beans@spill-beans

• Manual Skill Download: Run this in your terminal to fetch the skill file directly:

  mkdir -p ~/.agents/skills/spill-beans
  curl -fsSL https://raw.githubusercontent.com/tianchengc/spill-beans/main/skills/spill-beans/SKILL.md -o ~/.agents/skills/spill-beans/SKILL.md

3. Google Antigravity

• For CLI Users: Install directly using the agy tool in your terminal:

  agy plugin install https://github.com/tianchengc/spill-beans

• For IDE Users: Run this in your terminal to fetch and install the skill globally:

  mkdir -p ~/.gemini/config/skills/spill-beans
  curl -fsSL https://raw.githubusercontent.com/tianchengc/spill-beans/main/skills/spill-beans/SKILL.md -o ~/.gemini/config/skills/spill-beans/SKILL.md

4. Gemini CLI

• As an Extension (Recommended): Install via the gemini CLI:

  gemini extensions install https://github.com/tianchengc/spill-beans

• Manual Skill Download: Run this in your terminal to fetch the skill file directly:

  mkdir -p ~/.gemini/skills/spill-beans
  curl -fsSL https://raw.githubusercontent.com/tianchengc/spill-beans/main/skills/spill-beans/SKILL.md -o ~/.gemini/skills/spill-beans/SKILL.md

---

📖 Examples & Workflow

Once installed, simply trigger the skill directly in your chat session.

1. How to Trigger

Invoke the command using slash commands or natural language:

• /spill-beans
• Act as my dev soulmate and spill the beans on today's dev progress!

2. Interactive Flow

1. Harvest Context: Agent reads session chat history (80% weight) and git diffs (20% weight) to extract breakthroughs and friction points.
2. Platform & Topic Selection: Choose between X (Twitter), LinkedIn, or Cross-Post Bundle, and select from 3 plain-language narrative observations.
3. Headline & Hook Selection: Select high-impact cover titles (for X) or dramatic 3-line founder hooks & value props (for LinkedIn).
4. Drafting & Visual Generation: Tailored copy is drafted and visual assets (1:1 text cards or 16:9 feature banner) are rendered.
5. Final Presentation: Clean, ready-to-publish copy with metadata-stripped visuals.

---

🤝 Cross-Agent Compatibility

Agent Platform	Integration Status	How to Use
Google Antigravity	🟢 Native Skill	/spill-beans or skill invocation
Claude Code	🟢 Fully Supported	Load SKILL.md instructions into prompt
OpenAI Codex	🟢 Fully Supported	Load SKILL.md instructions into prompt

---

📜 License

MIT License © 2026. Built with 🫘 by developers, for developers building in public.

---

If SpillBeans saved you 45 minutes of writing today, give it a ⭐ on GitHub!