Skip to content

an orchestration tool with specialized skilled agents, to get much better outputs, and automate everything. for vibe coders

Notifications You must be signed in to change notification settings

vibeforge1111/vibeship-spawner

Repository files navigation

VibeShip Spawner

"You vibe. It ships."

Transform Claude into a specialist that actually knows your stack's gotchas, remembers your project decisions, and catches issues before they become problems.


Why Spawner?

Claude is brilliant, but it doesn't know what it doesn't know.

Problem How Spawner Fixes It
Claude forgets your project between sessions Project Memory - decisions, issues, and progress persist
Claude suggests patterns that break in production Sharp Edges - 2,000+ gotchas from real-world failures
Claude misses security issues in code Guardrails - automated checks catch vulnerabilities
Claude gives generic advice 462 Specialist Skills - deep expertise in specific domains
Claude doesn't know when to hand off Skill Collaboration - knows when another skill should take over

The Differentiation

Most AI coding tools give you a generalist. Spawner gives you a team of specialists that:

  • Know the specific gotchas for Next.js 14, Supabase RLS, Stripe webhooks
  • Remember that you chose Drizzle over Prisma and why
  • Catch the 'use server' directive you forgot
  • Hand off authentication work to the auth-specialist when needed

Quick Start

1. Add Spawner to Claude

Claude Code (CLI):

claude mcp add --transport http spawner https://mcp.vibeship.co/mcp

Claude Desktop:

Add to your MCP configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "spawner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vibeship.co"]
    }
  }
}

Restart Claude Desktop.

2. Install Skills (One Command)

npx vibeship-spawner-skills install

This installs 462 specialist skills to ~/.spawner/skills/. Zero cost, works offline.

3. Start Building

You: I want to build a marketplace for digital art

Claude: [Detects your skill level, asks 2-3 questions, recommends stack]
        I recommend the marketplace template with Next.js, Supabase, and Stripe...

What's Next?

Common Workflows

Building a SaaS:

1. Load the backend + auth-specialist + stripe-integration skills
2. Ask Claude to scaffold your app
3. Use spawner_validate before each commit

Debugging Production Issues:

1. Load the debugging-master skill
2. Describe the issue to Claude
3. Use spawner_unstick if you've been stuck 30+ minutes

Adding a New Feature:

1. Load the relevant skill (e.g., realtime-engineer for WebSockets)
2. Ask Claude - it now knows the gotchas for that domain
3. Use spawner_watch_out to see sharp edges for your stack

Pro Tips

  • Start sessions with spawner_orchestrate - it auto-detects your project context
  • Load skills before asking questions - Claude becomes a specialist, not a generalist
  • Use spawner_remember - save decisions so Claude remembers next session
  • Check spawner_validate before commits - catches security issues and anti-patterns

How It Works

Loading a Skill

Tell Claude to read a skill when you need specialist knowledge:

You: Read ~/.spawner/skills/development/backend/skill.yaml

Claude: [Now has deep backend expertise, patterns, anti-patterns, and gotchas]

Quick Skill Commands

Need Command
Backend API Read ~/.spawner/skills/development/backend/skill.yaml
Authentication Read ~/.spawner/skills/development/auth-specialist/skill.yaml
Database Read ~/.spawner/skills/data/postgres-wizard/skill.yaml
Frontend Read ~/.spawner/skills/development/frontend/skill.yaml
AI/LLM Read ~/.spawner/skills/ai/llm-architect/skill.yaml

Using MCP Tools

Tool When to Use
spawner_orchestrate Start of any session - auto-detects context
spawner_analyze Analyze existing codebase
spawner_validate Check code for issues
spawner_watch_out Get gotchas for your current stack
spawner_unstick When you've been stuck for 30+ minutes
spawner_remember Save important decisions

Updating Skills

Skills are updated regularly with new gotchas and patterns.

npx vibeship-spawner-skills update

Or manually:

cd ~/.spawner/skills && git pull

Why YAML Skills?

The Problem with Prompts

Traditional prompt libraries are:

  • Monolithic - one giant prompt tries to do everything
  • Stale - no versioning, no updates
  • Generic - not tailored to specific technologies

Our Approach: Structured YAML

Each skill has 4 focused files:

postgres-wizard/
├── skill.yaml           # Identity, patterns, what it owns
├── sharp-edges.yaml     # Specific gotchas (not generic advice)
├── validations.yaml     # Machine-checkable rules
└── collaboration.yaml   # When to hand off to other skills

Why this works:

  • Modular - load only what you need
  • Versionable - track changes over time
  • Specific - each gotcha has detection patterns
  • Collaborative - skills know their boundaries

Why 35 Categories?

We organize by domain expertise, not file type:

~/.spawner/skills/
├── game-dev/        # 51 skills - Unity, Godot, Phaser
├── marketing/       # 36 skills - AI video, SEO, content
├── integrations/    # 25 skills - AWS, Stripe, Discord
├── ai/              # 24 skills - LLM, embeddings, RAG
├── ai-agents/       # 23 skills - autonomous, multi-agent
├── creative/        # 23 skills - memes, viral, gamification
├── devops/          # 22 skills - CI/CD, Docker, K8s
├── backend/         # 21 skills - APIs, microservices
├── maker/           # 11 skills - viral tools, bots, SaaS
└── ...              # 26 more categories

This mirrors how real teams work - you don't ask a frontend dev about database indexing.


Troubleshooting

Skills not loading?

# Check if skills are installed
ls ~/.spawner/skills

# Reinstall if missing
npx vibeship-spawner-skills install

MCP not connecting?

Claude Code:

# Check if spawner is configured
claude mcp list

# Re-add if missing
claude mcp add --transport http spawner https://mcp.vibeship.co/mcp

Claude Desktop:

  1. Verify config in claude_desktop_config.json
  2. Restart Claude Desktop completely
  3. Check that npx is in your PATH

Tools not appearing?

  • Type /mcp in Claude Code to check MCP status
  • Ensure you're in a project directory (not home folder)
  • Try: claude mcp remove spawner then re-add

Still stuck?


Skills Directory

Browse all 462 skills online

Game Development (51 skills)

Unity, Godot, Phaser, and game design patterns.

Skill What It Knows
unity-development C# patterns, DOTS/ECS, physics, rendering
godot-development GDScript, signals, nodes, scene composition
phaser-gamedev 2D games, arcade physics, tilemaps
game-design-patterns State machines, object pools, ECS
multiplayer-netcode Rollback, prediction, authoritative servers
procedural-generation Terrain, dungeons, noise functions
game-audio FMOD, Wwise, adaptive music
game-ui-ux HUD design, menus, accessibility
...and 43 more

Backend (21 skills)

APIs, microservices, and server patterns.

Skill What It Knows
backend API design, server patterns, error handling
api-designer REST/GraphQL design, versioning, documentation
microservices Service mesh, CQRS, event sourcing
caching-strategies Redis, CDN, cache invalidation
graphql-schema Schema design, DataLoader, federation
elasticsearch-search Full-text search, aggregations, mapping
...and 15 more

Data (11 skills)

Databases, caching, and data pipelines.

Skill What It Knows
postgres-wizard Query optimization, indexing, RLS
redis-specialist Caching patterns, pub/sub, sessions
vector-specialist Embeddings, similarity search, pgvector
graph-engineer Neo4j, graph modeling, traversals
temporal-craftsman Workflow orchestration, durable execution
data-engineer ETL, pipelines, data quality
...and 5 more

AI (24 skills)

Machine learning, LLMs, and AI applications.

Skill What It Knows
llm-architect Model selection, prompting, fine-tuning
llm-fine-tuning LoRA, PEFT, training data
computer-vision-deep CNNs, object detection, segmentation
nlp-advanced Transformers, NER, sentiment
distributed-training Multi-GPU, DeepSpeed, FSDP
model-optimization Quantization, pruning, ONNX
multimodal-ai Vision-language models, CLIP
...and 17 more

AI Agents (23 skills)

Autonomous systems and automation.

Skill What It Knows
autonomous-agents Agent loops, tool use, planning
multi-agent-orchestration Agent coordination, handoffs
browser-automation Playwright, scraping, testing
computer-use-agents Screen interaction, GUI automation
voice-agents Speech-to-text, TTS, voice UX
workflow-automation n8n, Zapier, custom workflows
agent-memory-systems Long-term memory, retrieval
agent-tool-builder Tool design, function calling
agent-evaluation Benchmarking, evals, metrics
...and 14 more

Marketing (36 skills)

Content, growth, and creative production.

Skill What It Knows
copywriting Headlines, CTAs, conversion copy
seo Technical SEO, content optimization
content-strategy Editorial calendars, audience research
ai-video-generation Runway, Pika, video workflows
ai-image-generation Midjourney, DALL-E, Flux prompts
viral-marketing Hooks, distribution, shareability
brand-storytelling Narrative, voice, positioning
...and 29 more

Maker (11 skills)

Build products that ship and make money.

Skill What It Knows
viral-generator-builder Shareable generators, seeded randomness
scroll-experience GSAP, Framer, scroll-driven storytelling
telegram-bot-builder Telegraf, inline keyboards, monetization
telegram-mini-app TON Connect, Mini App patterns
micro-saas-launcher 2-week MVP, validation, Stripe
browser-extension-builder MV3, content scripts, chrome.storage
ai-wrapper-product API wrappers, prompt templates, cost tracking
notion-template-business Template sales, pricing, distribution
personal-tool-builder Scratch your itch, CLI tools, automation
...and 2 more

Creative (23 skills)

Memes, viral hooks, gamification, and creative chaos.

Skill What It Knows
meme-engineering Format selection, timing, distribution
viral-hooks Attention patterns, shareability
gamification-loops Engagement mechanics, progression
easter-egg-design Hidden features, discovery moments
generative-art Creative coding, p5.js, shaders
...and 18 more

Integrations (25 skills)

Platform-specific expertise and API connections.

Skill What It Knows
aws-serverless Lambda, API Gateway, DynamoDB
gcp-cloud-run Cloud Run, Pub/Sub, Firestore
stripe-integration Payments, subscriptions, webhooks
discord-bot-architect Discord.js, slash commands, bots
slack-bot-builder Slack API, Block Kit, workflows
twilio-communications SMS, voice, WhatsApp
...and 19 more

Community (11 skills)

Build and manage thriving communities.

Skill What It Knows
community-strategy Community design, engagement models
discord-mastery Server setup, bots, moderation
telegram-mastery Groups, channels, bots
ambassador-programs Recruitment, incentives, scaling
developer-community DevRel, docs, developer experience
...and 6 more

DevOps (22 skills)

CI/CD, infrastructure, and operations.

Skill What It Knows
devops CI/CD, deployment, infrastructure
docker-specialist Containerization, compose, optimization
kubernetes-deployment K8s patterns, scaling, monitoring
observability-sre Metrics, logs, traces, alerting
infra-architect Cloud architecture, cost optimization
...and 17 more

Frameworks (12 skills)

Framework-specific patterns and gotchas.

Skill What It Knows
nextjs-app-router App Router, RSC, Server Actions
react-patterns Hooks, state, performance
sveltekit SvelteKit routing, SSR, forms
supabase-backend Auth, RLS, Edge Functions
tailwind-ui Utility-first CSS, components
typescript-strict Type safety, generics, inference
...and 6 more

Mind (10 skills)

Thinking frameworks and problem-solving.

Skill What It Knows
debugging-master Root cause analysis, systematic debugging
system-designer Architecture, trade-offs, scaling
decision-maker Framework for technical decisions
refactoring-guide Safe refactoring patterns
tech-debt-manager Prioritization, payoff strategies
incident-responder On-call, postmortems, recovery
...and 4 more

Additional Categories (17 more)

Category Count Focus
Strategy 24 Product strategy, growth, competitive intel
Blockchain 20 Smart contracts, DeFi, NFTs, Solana
Security 13 Auth, OWASP, compliance, privacy
Design 12 UI, UX, branding, landing pages
Education 7 Course creation, AI tutoring, learning design
Product 7 A/B testing, analytics, PM
Finance 6 Algorithmic trading, DeFi, derivatives
Trading 6 Execution algorithms, quant research
Enterprise 6 Compliance, governance, architecture
Biotech 6 Genomics, drug discovery, lab automation
Hardware 6 Embedded, FPGA, robotics
Legal 5 GDPR, contracts, patents
Space 5 Orbital mechanics, mission planning
Climate 5 Carbon accounting, sustainability
Simulation 5 Monte Carlo, digital twin, physics
Communications 5 Developer relations, crisis comms
Startup 3 YC playbook, founder mode

License

Apache 2.0


Built with VibeShip
"You vibe. It ships."

About

an orchestration tool with specialized skilled agents, to get much better outputs, and automate everything. for vibe coders

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published