Takomi

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 CEO, and your AI assistants as a specialized, high-performance development team — an Architect who plans, a Builder who implements, a Reviewer who catches mistakes, and an Orchestrator who coordinates them all.

This isn't prompt engineering. This is orchestrated development — a battle-tested collection of protocols, workflows, and skills that transform AI coding assistants into genuine project partners. It works across every major AI-powered IDE and even browser-based AI like ChatGPT and Claude.

Features

• 🧠 95+ Skills — Specialized capabilities from security audits to AI video generation, installed on demand
• 🔄 Universal IDE Sync — Install once, sync to Antigravity, Claude Code, Codex, Cursor, Kilo Code, Pi, and Windsurf
• 🏗️ Full Project Lifecycle — From genesis (planning) through design, build, and finalize — with verification gates at every step
• 🎭 Specialized Agent Modes — Orchestrator, Architect, Coder, Debugger, Reviewer — each with purpose-built workflows
• 📦 Codex-Native Skills — Use natural language (use takomi genesis) — no slash commands required
• 🔌 Pi Harness Integration — First-class Pi support with context management, model routing, and optional feature packs
• 🌐 Global Skills Router — One ~/.takomi/ store, synced to every IDE via symlinks or copy

Quick Start

npm install -g takomi
takomi setup

That's it. Takomi auto-detects your installed IDEs, creates your toolkit at ~/.takomi/, and syncs your selected skills everywhere.

# Day-to-day usage
takomi              # Launch in your current project
takomi status       # See what's connected
takomi refresh      # One-command update for everything
takomi doctor       # Run diagnostics

Pi Harness

takomi setup pi
cd my-project
takomi

Optional global skills and feature packs:

takomi setup skills        # Core Skills on first install, custom category browser on repeat
takomi setup pi-features   # Optional Pi packages (Interview, Todo, Browser QA, Doc Preview)

Codex Plugin Marketplace

Add the Takomi marketplace to Codex and browse plugins directly from the Codex UI:

Add the marketplace source — In Codex, go to Plugins → Add plugin marketplace and enter:

| Field | Value | |-------|-------| | Source | JStaRFilms/VibeCode-Protocol-Suite | | Git ref | main | | Sparse paths | .agents/pluginsplugins |

Tip: For the full J StaR plugin catalog, use .agents/plugins and plugins as sparse paths instead.

Once added, search for "TakomiFlow" or "takomi-codex" inside the Codex plugin browser and install.

You can also use Takomi skills with natural language — no slash commands needed:

use takomi
use takomi genesis
continue build with takomi

See Takomi Codex Onboarding for activation, policy loading, roadbooks, and troubleshooting.

Per-Project Setup

Drop workflows into a single project without global install:

npx takomi init

Choose from .agent folder (Cursor, Windsurf, Gemini Code Assist), Agent YAMLs (Kilo Code), or legacy protocols (browser AI).

Global Install (Multi-IDE)

Install once. Use everywhere. Skills follow you across all detected AI harnesses:

npx takomi install

Browser-Based AI (ChatGPT, Claude.ai, Gemini)

1. Open a .md file from Legacy (Manual Method)/
2. Copy the entire prompt
3. Paste into your AI chat
4. Follow the conversation flow

| # | Protocol | Purpose | |---|----------|---------| | 1 | Project Genesis Protocol | Start any new project | | 2 | Ultimate Orchestration Prompt | One-shot prompt for quick scripts | | 3 | Design System Genesis Protocol | Create visual design systems | | 5 | Escalation & Handoff Protocol | When AI gets stuck | | 9 | Reverse Genesis Protocol | Onboard AI to existing codebases |

TakomiFlow packages Google Flow image/video generation as a Codex plugin with MCP tools plus a CLI fallback. It can generate Flow keyframes, short video shots, moodboards, collect downloaded assets, extract review frames, and record Flow project URLs.

.\scripts\install-takomi-flow.ps1 -InstallDependencies

See TakomiFlow Onboarding and TakomiFlow Public Distribution.

Skill Ecosystem

Think of skills as specialized team members you can summon on demand. Takomi ships 95+ skills organized by category.

Core Skills (Default Install)

takomi                 ai-sdk                 sync-docs
code-review            security-audit         optimize-agent-context
agent-recovery         avoid-feature-creep    git-commit-generation

Install More Skills

# Interactive browser — pick what you need
takomi setup skills

# Or via the external skills CLI
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite

Developer / Frameworks — ai-sdk, nextjs-standards, context7, monorepo-management, upgrading-expo, github-ops, git-worktree, git-commit-generation, pr-comment-fix, jules, gemini, anti-gravity

Security / Review — security-audit, audit-website, code-review, jstar-reviewer, convex-security-audit, convex-security-check

Convex — convex, convex-agents, convex-best-practices, convex-component-authoring, convex-cron-jobs, convex-file-storage, convex-functions, convex-http-actions, convex-migrations, convex-realtime, convex-schema-validator, convex-security-audit, convex-security-check

Frontend / UI — frontend-design, web-design-guidelines, building-native-ui, ui-ux-pro-max, component-analysis, 21st-dev-components, stitch, webapp-testing, figma

Docs / Office / Extraction — pdf, docx, pptx, xlsx, high-fidelity-extraction, crafting-effective-readmes, exam-creator-skill

Marketing / SEO / Copy — copywriting, marketing-ideas, pricing-strategy, programmatic-seo, seo-ready, social-content, twitter-automation, google-trends, domain-name-brainstormer, global-brand-namer, youtube-pipeline

AI Media / Content Creation — ai-avatar-video, ai-marketing-videos, ai-podcast-creation, ai-product-photography, ai-social-media-content, ai-voice-cloning, takomi-flow

Creative / Video / Art — algorithmic-art, blender-mcp-scene-director, takomi-flow, remotion, remotion-real-ui-video, youtube-pipeline, ai-avatar-video, ai-marketing-videos, photo-book-builder, hyperframes, general-video, motion-graphics

HyperFrames — hyperframes, hyperframes-core, hyperframes-keyframes, hyperframes-animation, hyperframes-creative, hyperframes-media, hyperframes-registry, hyperframes-cli, remotion-to-hyperframes, media-use, embedded-captions, faceless-explainer, general-video, motion-graphics, music-to-video, pr-to-video, product-launch-video, slideshow, talking-head-recut, website-to-video

Skill Building / Prompting / Orchestration — skill-creator, prompt-engineering, subagent-driven-development, spawn-task

Workflows & Modes

Project Lifecycle

| Command | What It Does | |---------|--------------| | /vibe-genesis | Architect a new project — PRD, issues, guidelines | | /vibe-design | Generate design system and page mockups | | /vibe-build | Scaffold and build 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 |

Specialized Modes

| Command | Role | When to Use | |---------|------|-------------| | /mode-orchestrator | Coordinator | Complex multi-agent projects | | /mode-architect | Planner | System design before coding | | /mode-code | Implementer | Day-to-day coding | | /mode-debug | Diagnostician | Hard-to-find bugs | | /mode-ask | Analyst | Explain without changing code | | /mode-review | Reviewer | Pre-commit quality gates |

Daily Commands

| Command | What It Does | |---------|--------------| | /vibe-primeAgent | Load project context at session start | | /vibe-spawnTask | Break down complex features into tasks | | /vibe-syncDocs | Update docs after code changes | | /escalate | Generate escalation report when stuck | | /migrate | Transfer context to a new session |

Supported IDEs

Install once into ~/.takomi/ — Takomi syncs skills to each harness automatically.

| Harness | Skills Path | Workflows Path | |---------|-------------|----------------| | Antigravity | ~/.gemini/config/skills/ | ~/.gemini/config/global_workflows/ | | Claude Code | ~/.claude/skills/ | — | | Codex | ~/.codex/skills/ | — | | Cursor | ~/.cursor/skills/ | — | | Kilo Code | ~/.kilocode/skills/ | ~/.kilocode/workflows/ | | Pi / Agent Skills | ~/.agents/skills/ | — | | Windsurf | ~/.codeium/windsurf/skills/ | ~/.codeium/windsurf/global_workflows/ |

| Command | What It Does | |---------|--------------| | takomi | Launch in the current project | | takomi setup | Guided first-time setup | | takomi setup pi\|skills\|project\|all | Targeted setup | | takomi refresh | One-command update (CLI + Pi + skills) | | takomi refresh pi\|skills\|project\|all | Targeted refresh | | takomi add <url> | Pull skills from any GitHub repo | | takomi status | See connections and toolkit status | | takomi doctor | Run diagnostics |

Legacy aliases: install → setup, sync/upgrade → refresh, init → setup project.

Takomi ships a Pi-native takomi-context-manager extension that reduces prompt bloat with progressive context loading:

• Skill names are always visible; descriptions and full SKILL.md files load only when needed
• Tools: skill_manifest, skill_load, policy_manifest, policy_load, context_report
• /takomi routing is the source of truth for model-routing policy
• /context-report shows prompt compaction, loaded skills/policies, blocked actions, and diagnostics
• Supports mode: "summary" | "verbose" | "problems"

Repository Structure

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

Philosophy

• Structured Collaboration — Clear roles for each AI agent, not free-form chatting
• Documentation-Driven — Every project gets proper docs, issues, and roadmaps
• Verification Gates — tsc --noEmit after every edit, 1:1 feature-to-issue mapping
• Scalable — Works for tiny scripts or enterprise applications
• Own Your Stack — No vendor lock-in, works across every major IDE

Contributing

This is a living system. If you discover improvements:

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

Takomi-original skills, workflows, and runtime extensions — including 21st-dev-components — are authored and maintained by J StaR Films Studios.

| Source | Skills / Packages | |--------|-------------------| | Pi by Mario Zechner / Earendil Works | MIT-licensed coding-agent runtime powering the Pi-native Takomi harness | | Anthropic Skills | Office Suite (PDF/DOCX/PPTX/XLSX), Frontend Design, Webapp Testing, Algorithmic Art, Monorepo Management, Skill Creator | | Inference.sh | Marketing Videos, Voice Cloning, Social Content, Twitter Automation, Product Photography, Prompt Engineering | | Marketing Skills | Copywriting, Pricing Strategy, Social Strategy, Programmatic SEO, Marketing Ideas | | Expo | Building Native UI, Upgrading Expo | | Vercel AI SDK | AI SDK reference, Web Design Guidelines | | UI/UX Pro Max | Premium design intelligence | | Remotion | Programmatic video creation | | HyperFrames | HTML-native video creation and animation framework: HyperFrames core, keyframes, creative, media OS, animation engine, registry, CLI, and specialized creator workflows (product launch, website showcase, faceless explainer, music video, PR walkthrough, overlays, captions) | | Subagent Development | Advanced implementation planning | | Context7 | Library documentation fetcher | | Audit Website | Professional website auditor | | Convex Skills | Full Convex suite (Functions, Schema, Realtime, Agents, File Storage, Migrations, HTTP Actions, Cron, Components, Security) | | Google Stitch | Design-to-code suite (design-md, enhance-prompt, stitch-loop, react-components, shadcn-ui) | | Jules | Google Jules AI agent delegation | | pi-subagents by Nico Bailon | Pi extension for delegated subagent runs | | rpiv-ask-user-question by juicesharp | Structured user questions (optional Pi pack) | | rpiv-todo by juicesharp | Live todo overlays (optional Pi pack) | | pi-chrome by tianrendong | Browser automation (optional Pi pack) | | pi-markdown-preview by omaclaren | Markdown/LaTeX previews (optional Pi pack) | | context-mode by Mert Koseoğlu | External context-window project (not bundled) | | kilocode by Kilo-Org | Git commit generation | | pr-comment-fix | PR review comment automation |

License

Takomi is licensed under the ISC License. Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.