takomi

v2.0.7

Published

13 days ago

🎯 Stop wrestling with AI. Start building with purpose. The artisan's toolkit for agent workflows, Codex skills, and original Takomi capabilities like 21st.dev integration.

0High
0Medium
0Low

johnsax

takomi ai skills codex agentic 21st.dev vibecode cursor windsurf protocols

Takomi

🎉 Rebrand Notice: VibeSuite is now Takomi!
If you're following tutorials that reference vibesuite or VibeCode, simply use takomi instead.
Example: npx vibesuite install → npx takomi install
The VibeCode Protocol lives on as the engine powering Takomi.

🚀 Quick Start (Recommended)

Option A: Global Install (Best for Multi-IDE Users) ⭐

Install once. Use everywhere. Your skills follow you across every AI harness(Antigravity, KiloCode, Windsurf, Cursor, Gemini CLI):

# Using pnpm
pnpm dlx takomi install

# Using npx
npx takomi install

What happens next:

🔍 Auto-detects every AI harness on your machine
📦 Creates your command center at ~/.takomi/
📡 Syncs your entire toolkit to every IDE automatically
🔄 Keeps KiloCode in sync across CLI and VS Code

Option B: Per-Project Setup

Need workflows for just this project? Drop them in with one command:

pnpm dlx takomi init

Choose your weapons:

✅ .agent Folder — Workflows for Cursor, Windsurf, Gemini Code Assist
✅ Agent YAMLs — Custom modes for Kilo Code
✅ Legacy Protocols — Copy-paste prompts for browser AI
✅ Cherry-pick exactly the workflows and skills you need

Codex Takomi Skills (No Slash Required)

Takomi now supports a full skill-native protocol path in Codex:

Router skill: takomi
Specialist skills: takomi-* (migrated from non-legacy workflows)
Backward phrase aliases: vibe genesis, vibe build, mode code, and related prior names

Use natural language:

use takomi
use takomi genesis
run vibe genesis
continue build with takomi

Install the Takomi protocol suite:

npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill takomi

Original Takomi-authored skills in this bundle include 21st-dev-components, takomi, global-brand-namer, jstar-reviewer, and the core VibeCode/Takomi workflow skills that ship with the CLI.

📦 Skill Ecosystem

Think of skills as specialized team members you can summon on demand. From security audits to AI video generation — there's a skill for that.

The published bundle currently ships 68 top-level skills, including the original 21st-dev-components workflow for guided 21st.dev integration.

Interactive Search & Install

# Using pnpm
pnpm dlx skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite

# Using npx
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite

Core Essentials (Start Here)

The non-negotiables for daily development:

npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill takomi

Convex Development Suite

Backend superpowers for the Convex ecosystem:

npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill convex --skill convex-agents --skill convex-best-practices --skill convex-component-authoring --skill convex-cron-jobs --skill convex-file-storage --skill convex-functions --skill convex-http-actions --skill convex-migrations --skill convex-realtime --skill convex-schema-validator --skill convex-security-audit --skill convex-security-check

AI Media Suite (Paid / Advanced)

For when you need more than code — videos, voice, images, and automation:

npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill ai-avatar-video --skill ai-marketing-videos --skill ai-podcast-creation --skill ai-product-photography --skill ai-social-media-content --skill ai-voice-cloning

The Full Arsenal (Free)

Everything else — SEO, research, documentation, testing, and beyond:

npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill 21st-dev-components --skill agent-recovery --skill algorithmic-art --skill audit-website --skill avoid-feature-creep --skill building-native-ui --skill code-review --skill component-analysis --skill context7 --skill convex --skill convex-agents --skill convex-best-practices --skill convex-component-authoring --skill convex-cron-jobs --skill convex-file-storage --skill convex-functions --skill convex-http-actions --skill convex-migrations --skill convex-realtime --skill convex-schema-validator --skill convex-security-audit --skill convex-security-check --skill copywriting --skill crafting-effective-readmes --skill docx --skill domain-name-brainstormer --skill frontend-design --skill gemini --skill git-worktree --skill github-ops --skill global-brand-namer --skill google-trends --skill high-fidelity-extraction --skill jstar-reviewer --skill jules --skill marketing-ideas --skill monorepo-management --skill nextjs-standards --skill optimize-agent-context --skill pdf --skill pptx --skill pricing-strategy --skill programmatic-seo --skill prompt-engineering --skill remotion --skill security-audit --skill seo-ready --skill skill-creator --skill social-content --skill spawn-task --skill stitch --skill subagent-driven-development --skill sync-docs --skill twitter-automation --skill ui-ux-pro-max --skill upgrading-expo --skill webapp-testing --skill web-design-guidelines --skill xlsx --skill youtube-pipeline

🌐 Global Skills Router (v2.0)

One install. Every IDE. Zero friction.

Takomi v2.0 introduces the Global Skills Router — install skills once, and they appear in every AI harness you use. No symlinks. No admin privileges. Works on Mac & Windows.

Supported Harnesses

| Harness | Global Skills Path | Global Workflows Path | |---|---|---| | Antigravity | ~/.gemini/antigravity/skills/ | ~/.gemini/antigravity/global_workflows/ | | KiloCode | ~/.kilocode/skills/ | ~/.kilocode/workflows/ | | Windsurf | ~/.codeium/windsurf/skills/ | ~/.codeium/windsurf/global_workflows/ | | Codex | ~/.codex/skills/ | (skills only) | | Cursor | ~/.cursor/skills/ | (uses rules) | | Gemini CLI | ~/.agents/skills/ | (skills only) |

CLI Commands

| Command | What It Does | |---|---| | takomi install | One-time setup — detects your IDEs, creates your toolkit, syncs everything | | takomi sync | Push updates from ~/.takomi/ to all linked harnesses | | takomi add <url> | Pull skills from any GitHub repo into your global store | | takomi harnesses | See what's connected and your toolkit status | | takomi init | Project-specific setup (works alongside global) | | takomi update | Refresh resources from GitHub (global store supported) |

Example: Add Remote Skills

# Pull skills from any GitHub repo into your global store
pnpm dlx takomi add https://github.com/JStaRFilms/VibeCode-Protocol-Suite

# See what's connected
pnpm dlx takomi harnesses

# Push updates everywhere
pnpm dlx takomi sync

KiloCode YAML Auto-Sync

When KiloCode is detected, takomi install syncs custom_modes.yaml to both locations automatically:

CLI: ~/.kilocode/cli/global/settings/custom_modes.yaml
Extension: %APPDATA%/Antigravity/User/globalStorage/kilocode.kilo-code/settings/custom_modes.yaml

🌟 What Is Takomi?

AI shouldn't feel like a chatbot. It should feel like a teammate.

Takomi is a complete workflow system for collaborating with AI to build software. Think of yourself as the Visionary/CEO, and your AI assistants as a specialized, high-performance development team that actually delivers.

This isn't prompt engineering. This is orchestrated development — a battle-tested collection of protocols, workflows, and prompts that transform AI from code generators into genuine project partners.

📂 Repository Structure

Built for two types of builders:

| Folder | Purpose | Who It's For | |--------|---------|--------------| | .agent/ | Workflows & Skills for agentic IDEs | Cursor, Windsurf, Gemini Code Assist users | | Legacy (Manual Method)/ | Copy-paste prompts & protocols | Browser-based AI users (ChatGPT, Claude.ai) | | Deep_Source_Prompts/ | Reference docs & source materials | Prompt engineers, contributors |

🤖 For Agentic IDE Users (Recommended)

Using Cursor, Windsurf, VS Code + Gemini Code Assist, or similar?
Everything you need is in the .agent/ folder.

Quick Setup

Copy the .agent/ folder to your project root
Your IDE automatically detects workflows and skills
Invoke with natural language in Codex (e.g., use takomi genesis) - slash commands are optional

What's Inside `.agent/`

.agent/
├── workflows/          # Executable step-by-step workflows
│   ├── vibe-genesis.md         # Start new projects (V3)
│   ├── vibe-design.md          # Generate design systems
│   ├── vibe-build.md           # Execute the build
│   ├── vibe-continueBuild.md   # Resume work in new sessions
│   ├── vibe-finalize.md        # Final verification & handoff
│   ├── vibe-spawnTask.md       # Break down complex features
│   ├── vibe-syncDocs.md        # Update documentation
│   ├── vibe-primeAgent.md      # Load project context
│   ├── reverse_genesis.md      # Onboard to existing codebases
│   │
│   ├── mode-orchestrator.md    # Coordinate multi-agent projects
│   ├── mode-architect.md       # Plan and design systems
│   ├── mode-code.md            # Write and refactor code
│   ├── mode-debug.md           # Diagnose issues
│   ├── mode-ask.md             # Explain and analyze
│   ├── mode-review.md          # Code review (manual)
│   └── ...
│
└── skills/             # Implicit capabilities (auto-activated)
    ├── prime-agent/        # Load project context
    ├── code-review/        # J-Star code review loop
    ├── security-audit/     # Deep security analysis
    ├── nextjs-standards/   # Next.js coding standards
    ├── vercel-ai-sdk/      # AI SDK reference docs
    ├── youtube-pipeline/   # Video production workflow
    └── ...

Key Workflows

🏗️ Project Lifecycle (V3)

| Slash Command | What It Does | |---------------|--------------| | /vibe-genesis | Architect a new project with PRD, Issues, and Guidelines | | /vibe-design | Generate design system and page mockups | | /vibe-build | Scaffold and build the project with verification gates | | /vibe-continueBuild | Resume work in a new chat session | | /vibe-finalize | Final verification and handoff report | | /reverse_genesis | Onboard AI to an existing codebase |

🎯 Mode Workflows (Specialized Roles)

| Slash Command | What It Does | |---------------|--------------| | /mode-orchestrator | Coordinate complex multi-agent projects | | /mode-architect | Plan and design technical systems | | /mode-code | Write and refactor code | | /mode-debug | Diagnose and troubleshoot issues | | /mode-ask | Explain and analyze without making changes | | /mode-review | Manual code review before commits |

🔄 Daily Development

| Slash Command | What It Does | |---------------|--------------| | /vibe-primeAgent | Load project context at start of session | | /vibe-spawnTask | Break down complex features into tasks | | /vibe-syncDocs | Update documentation after code changes | | /mode-review_code | Run J-Star automated code review | | /escalate | Generate escalation report when stuck | | /migrate | Transfer context to a new chat session |

📋 For Browser-Based AI Users

Using ChatGPT, Claude.ai, or Gemini in the browser?
Use the Legacy (Manual Method)/ folder with copy-paste prompts.

The Protocol Library

| # | Protocol | Purpose | |---|---|----------| | 0 | Takomi User Manual | Complete guide to the system | | 1 | Project Genesis Protocol | Start any new project (99% of cases) | | 2 | Ultimate Orchestration Prompt | One-shot prompt for quick scripts | | 3 | Design System Genesis Protocol | Create visual design systems | | 4 | GitHub Issue Meta-Prompt | Structured issue creation | | 5 | Escalation & Handoff Protocol | When AI gets stuck | | 8 | Seamless Migration Meta-Prompt | Transfer context between sessions | | 9 | Reverse Genesis Protocol | Onboard AI to existing codebases |

How to Use

Open the relevant .md file from Legacy (Manual Method)/
Copy the entire prompt
Paste it into your AI chat interface
Follow the conversation flow

📚 Deep Source Prompts (For Contributors)

The Deep_Source_Prompts/ folder contains the reference documentation and source materials used to create the workflows and protocols.

Coding Guidelines — React/TypeScript and Next.js App Router standards
Vercel AI SDK Docs — Complete AI SDK reference (building RAG, streaming, tools)
Design System Docs — Google's Material Design 3, mobile-first patterns
Agent Prompts — Raw system prompts for various AI agents
OpenRouter Docs — API reference for multi-model routing

Note: These are raw, unprocessed reference materials. They're useful for understanding why the workflows are structured the way they are, or for creating new workflows.

🎯 The Takomi Philosophy

Structured Collaboration: Clear roles for different AI agents (Genesis, Designer, Builder, Orchestrator, Architect, Coder, Debugger)
End-to-End Workflows: From project genesis to debugging escalations
Documentation-Driven: Every project gets proper docs, issues, and roadmaps
Multi-Agent Orchestration: Coordinate specialized agents for complex projects
Scalable: Works for tiny scripts or enterprise applications

🆕 What's New (V3 + Mode Workflows)

V3 Project Workflows

The V3 workflows introduce verification gates, TypeScript strict mode, and better continuation support:

tsc --noEmit after every file edit
1:1 Feature Requirement ↔ Issue correlation
Templates from nextjs-standards skill
Seamless session continuation with /vibe-continueBuild

Mode Workflows (KiloCode-Inspired)

New specialized mode workflows for targeted tasks:

/mode-orchestrator — Coordinate multi-agent projects with session-based task management
/mode-architect — Plan and design before coding
/mode-code — Focused implementation mode
/mode-debug — Systematic troubleshooting
/mode-ask — Analysis without changes
/mode-review — Quality assessment

Naming Convention

vibe-* workflows = Project lifecycle (genesis, design, build, continue, finalize)
mode-* workflows = Specialized agent modes (orchestrator, architect, code, debug, ask, review)
Skills = Reusable capabilities with auto-loading (in .agent/skills/)

👥 Your AI Team

Project Workflows (Vibe Series)

| Role | Workflow | Responsibility | When to Use | |------|----------|---------------|-------------| | Genesis | /vibe-genesis | Strategic planning, PRD creation, issue generation | Starting new projects | | Designer | /vibe-design | Visual design systems, UI mockups | Before implementation | | Builder | /vibe-build | Initial code implementation with verification | Building the foundation | | Continuer | /vibe-continueBuild | Resume work in new sessions | Continuing after breaks | | Finalizer | /vibe-finalize | Verification, handoff reports | Project completion |

Mode Workflows (Specialized Modes)

| Role | Workflow | Responsibility | When to Use | |------|----------|---------------|-------------| | Orchestrator | /mode-orchestrator | Coordinate multi-agent projects, delegate tasks | Complex projects requiring coordination | | Architect | /mode-architect | Technical planning, system design | Before coding complex features | | Coder | /mode-code | Write, refactor, implement code | Day-to-day coding tasks | | Debugger | /mode-debug | Systematic issue diagnosis | When bugs are hard to find | | Analyst | /mode-ask | Explain, analyze, recommend | Understanding code without changes | | Reviewer | /mode-review | Code quality assessment | Pre-commit quality gates |

🚀 Quick Start Guide

For Agentic IDE Users

# 1. Copy .agent folder to your project root
cp -r path/to/VibeCode-Protocol-Suite/.agent ./

# 2. Start a new project (V3 Workflow)
# Type: /vibe-genesis

# 3. Generate design system
# Type: /vibe-design

# 4. Build the project
# Type: /vibe-build

# 5. Continue in new sessions
# Type: /vibe-continueBuild

# 6. Finalize and handoff
# Type: /vibe-finalize

For Complex Multi-Agent Projects

See the Takumi orchestration build plan: docs/takumi_code_v0.001_plan.md.

# Use the orchestrator to coordinate multiple specialized agents
# Type: /mode-orchestrator

# The orchestrator will:
# 1. Break down your project into subtasks
# 2. Create task files in docs/tasks/orchestrator-sessions/[ID]/
# 3. Guide you to spawn sub-agents for each task
# 4. Track completion and synthesize results

For Browser AI Users

# 1. Open: Legacy (Manual Method)/1 Project Genesis Protocol The VibeCode Workflow.md
# 2. Copy the entire content
# 3. Paste into ChatGPT/Claude/Gemini
# 4. Follow the conversation flow

🤝 Contributing

This is a living system. If you discover improvements:

Test your changes with real projects
Add reference materials to Deep_Source_Prompts/ if needed
Create workflows in .agent/workflows/ for agentic IDEs
Update legacy prompts in Legacy (Manual Method)/ for browser users
Create a GitHub Issue with your proposed changes

🙏 Acknowledgements

Externally sourced skills in this bundle retain credit to their upstream creators. Takomi-original skills and workflows in this repository, including 21st-dev-components, remain authored and maintained by J StaR Films Studios.

Anthropic Skills: From anthropics/skills — a massive collection including Office Suite (PDF/DOCX/PPTX/XLSX), Frontend Design, Webapp Testing, Algorithmic Art, Monorepo Management, and Skill Creator.
Inference.sh Skills: From inference.sh/skills — complete media & automation suite including Marketing Videos, Voice Cloning, Social Content, Twitter Automation, Product Photography, and Prompt Engineering.
Marketing Skills: From coreyhaines31/marketingskills — the complete marketer's toolkit: Copywriting, Pricing Strategy, Social Strategy, Programmatic SEO, and Marketing Ideas.
Expo Skills: From Expo — Building Native UI (React Native/Expo Router) and Upgrading Expo guide.
Vercel AI SDK: From vercel/ai — AI SDK reference and Web Design Guidelines.
UI/UX Pro Max: From Next Level Builder — premium design intelligence.
Remotion: From Remotion — programmatic video creation.
Subagent Development: From obra/superpowers — advanced implementation planning.
Context7: From upstash/context7 — fresh library documentation fetcher.
Audit Website: From squirrelscan/skills — professional website auditor.
Convex Skills: From waynesutton/convexskills — complete Convex development suite including Functions, Schema Validation, Realtime, Agents, File Storage, Migrations, HTTP Actions, Cron Jobs, Component Authoring, Best Practices, Security Audit, Security Check, Avoid Feature Creep, and Optimize Agent Context.
Gemini CLI: Custom VibeCode skill for large-context processing with Gemini 3 Pro.
Google Stitch Skills: From google-labs-code/stitch-skills — Design-to-code suite including design-md, enhance-prompt, stitch-loop, react-components, and shadcn-ui.
Jules: From sanjay3290/ai-skills — delegate coding tasks to Google Jules AI agent.

📄 License

This repository contains workflow protocols and prompts. Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.