Takomi

🎯 Stop Wrestling With AI. Start Building With Purpose.

The artisan's toolkit that transforms AI from chatbot to development partner

---

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

📋 More install options (Pi, Codex, per-project, browser)

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/plugins plugins

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 (Google Flow Assets)

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

📚 Full skill categories

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/

🔧 CLI reference

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.

🧩 Context Manager (Pi)

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

---

🙏 Acknowledgements

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.

---

Built with ❤️ by artisans who code with the flow

Transform AI from a tool into a true development partner