KatXAgentKit

A host-agnostic agent kit that ships skills, workflows, and sub-agents for AI-powered CLI coding agents. One canonical .agents workspace is shared across Claude Code, OpenCode, and Antigravity.

Why?

AI coding agents (Claude Code, OpenCode, Antigravity) are powerful out-of-the-box, but they lack domain memory — curated skills, reusable workflows, and specialized sub-agents that encode how your team builds software. KatXAgentKit fills that gap with a single installable kit.

Quick Start

Install

To install the kit globally, simply run:

npm install -g @katx-vn/katx-agent-kit

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/katx-vn/katx-agent-kit/main/cli/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/katx-vn/katx-agent-kit/main/cli/install.ps1 | iex

# Or clone manually (requires repo access)
git clone --depth 1 [email protected]:katx-vn/katx-agent-kit.git ~/.katx-agent
cd ~/.katx-agent/cli && npm install && npm link

Initialize a project

cd /path/to/your-project

# Interactive — pick platforms, presets, individual skills
katx-kit init

# Or use a preset directly
katx-kit init --preset frontend --platform claude,antigravity

Start developing

# Claude Code
claude
/katx:plan "implement user authentication"
/katx:cook "add database integration"

# GitHub Copilot (VS Code)
# Use @agent mentions and /prompt commands in Copilot Chat

# OpenCode
opencode
/katx:plan "implement user authentication"

Supported Platforms

| Platform | Mirror Dir | Description | |----------|-----------|-------------| | Claude Code | .claude/ | Deepest mirror — native skills, commands, hooks, sub-agents | | GitHub Copilot | .github/ | Agents, workspace instructions, and prompts for VS Code Copilot | | OpenCode | .opencode/ | Command and agent surface tuned for OpenCode workflows | | Antigravity | .agents/ | Workspace rules and workflows via the canonical tree | | Codex CLI | .codex/ | Agent profiles, config, and hooks for OpenAI Codex CLI |

All platforms share .agents/ as the single source of truth.

What's Inside

| Type | Count | Examples | |------|-------|---------| | Skills | 33 | planning, debugging, code-review, frontend-design, ai-multimodal, databases, devops, shopify, mobile-development | | Workflows | 57 | /plan, /cook, /fix, /test, /debug, /design, /bootstrap, /git-cm, /docs-init, /brainstorm, /content, /review-codebase | | Agents | 16 | planner, researcher, tester, debugger, code-reviewer, scout, docs-manager, git-manager, ui-ux-designer, copywriter | | Presets | 7 | minimal, frontend, website-cloner, backend, fullstack, ai-engineer, mobile |

Presets

| Preset | Skills | What you get | |--------|--------|-------------| | 🎯 Minimal | 7 | Planning, debugging, code-review, research, problem-solving | | 🎨 Frontend | 14 | Core + frontend-design, UI styling, Three.js, Chrome DevTools, aesthetic | | ⚙️ Backend | 11 | Core + backend, databases, auth, devops | | 🚀 Full-Stack | All | Every skill, workflow, and agent | | 🤖 AI Engineer | 13 | Core + AI multimodal, MCP, media processing, Google ADK | | 📱 Mobile | 9 | Core + mobile development, UI styling |

CLI Commands

katx-kit init                          # Interactive setup
katx-kit init --preset minimal         # Use a preset
katx-kit init --platform claude        # Target specific platform
katx-kit init --platform codex         # OpenAI Codex CLI

katx-kit add skill frontend-design     # Add with dependency resolution
katx-kit add workflow design           # Add a workflow group
katx-kit add agent ui-ux-designer      # Add a sub-agent

katx-kit remove skill threejs          # Remove (with safety check)
katx-kit list                          # List all components
katx-kit list --type skills --installed # Filter installed skills
katx-kit update                        # Pull latest & sync
katx-kit docs                          # Open interactive docs

Project Structure

├── .agents/                  # ← Canonical source of truth
│   ├── agents/               #    16 sub-agent definitions
│   ├── skills/               #    33 skill modules (SKILL.md + scripts)
│   ├── workflows/            #    57 slash-command workflows
│   └── rules/                #    Workspace rules (primary-workflow, dev-rules, orchestration)
├── .claude/                  # Claude Code mirror (agents, commands, hooks, skills)
├── .github/                  # GitHub Copilot mirror (agents, instructions, prompts)
│   ├── agents/               #    *.agent.md definitions
│   ├── instructions/         #    *.instructions.md workspace rules
│   ├── prompts/              #    *.prompt.md workflows
│   └── copilot-instructions.md  # Global Copilot workspace context
├── .opencode/                # OpenCode mirror (agents, commands)
├── .codex/                   # Codex CLI mirror (agent profiles, config, hooks)
├── cli/                      # katx-kit CLI tool
│   ├── bin/                  #    CLI entrypoint
│   ├── src/                  #    Commands, core logic, UI
│   ├── docs/                 #    Interactive docs site
│   ├── install.sh            #    Linux/macOS installer
│   └── install.ps1           #    Windows installer
├── docs/                     # Project documentation
│   ├── system-architecture.md
│   ├── project-overview-pdr.md
│   ├── code-standards.md
│   ├── codebase-summary.md
│   └── project-roadmap.md
├── guide/                    # Reference guides (skills, commands)
├── manifest.json             # Component registry (skills, workflows, agents, presets)
├── CLAUDE.md                 # Claude Code development instructions
├── AGENTS.md                 # Agent coordination guidelines
├── GEMINI.md                 # Gemini CLI / MCP proxy config
└── README.md                 # This file

Workflow Slash Commands

Workflows are grouped by function. Use them as slash commands in Claude Code or OpenCode:

| Group | Commands | Description | |-------|----------|-------------| | Plan | /plan, /plan-fast, /plan-hard, /plan-two | Research → plan with varying depth | | Implement | /cook, /cook-auto, /cook-auto-fast, /code | Execute implementation plans | | Fix | /fix, /fix-fast, /fix-hard, /fix-ci, /fix-logs, /fix-test, /fix-types, /fix-ui | Debug & fix issues | | Test | /test | Run tests & analyze results | | Design | /design-fast, /design-good, /design-3d, /design-screenshot, /design-video | Create UI designs | | Bootstrap | /bootstrap, /bootstrap-auto, /bootstrap-auto-fast | Scaffold new projects | | Git | /git-cm, /git-cp, /git-pr | Stage, commit, push | | Docs | /docs-init, /docs-update | Generate & update documentation | | Content | /content-fast, /content-good, /content-enhance, /content-cro | Write & optimize copy | | Review | /review-codebase | Scan & analyze codebase | | Other | /ask, /brainstorm, /watzup, /journal, /use-mcp | Q&A, ideation, status, MCP tools |

The Agent Team

16 specialized sub-agents coordinate through file-based communication:

| Agent | Role | |-------|------| | Planner | Technical planning & architecture design | | Researcher | Technology investigation & analysis | | Tester | Test generation & validation | | Debugger | Root cause analysis & diagnosis | | Code Reviewer | Code quality & standards enforcement | | Scout | Codebase file discovery & pattern analysis | | Scout External | External dependency & codebase analysis | | Docs Manager | Documentation synchronization | | Git Manager | Commit messages & version control | | Project Manager | Progress tracking & project health | | UI/UX Designer | Interface design & user experience | | Brainstormer | Creative ideation & feature exploration | | Copywriter | Content writing & copy optimization | | Database Admin | Database management & optimization | | Journal Writer | Development journals & decision logging | | MCP Manager | MCP server management & tool execution |

Gemini API Skills

Several skills use the Google Gemini API (ai-multimodal, media-processing, document-skills). Set up your key:

# Environment variable (recommended)
export GEMINI_API_KEY='your-key'

# Or in project .env
echo 'GEMINI_API_KEY=your-key' > .env

Get your key at: https://aistudio.google.com/apikey

MCP Integration

Configure MCP servers in .claude/.mcp.json:

cp .claude/.mcp.json.example .claude/.mcp.json
# Edit and add your MCP servers

Example servers: Context7, Chrome DevTools MCP, Human MCP.

Update

# Via npm (recommended)
npm update -g @katx-vn/katx-agent-kit

# Or re-run the install script (auto-detects existing install)
curl -fsSL https://raw.githubusercontent.com/katx-vn/katx-agent-kit/main/cli/install.sh | bash

# Or manually (requires repo access)
cd ~/.katx-agent && git pull && cd cli && npm install

Prerequisites

• Node.js 18+
• Git
• Access to @katx-vn/katx-agent-kit GitHub Package (PAT with read:packages)

Development Principles

• YAGNI — avoid over-engineering
• KISS — prefer simple solutions
• DRY — remove duplication when it improves clarity

Documentation

| Document | Description | |----------|-------------| | System Architecture | Component interactions & data flow | | Project Overview & PDR | Goals, features, product requirements | | Code Standards | Naming conventions & best practices | | Codebase Summary | High-level project structure overview | | Skills Reference | Complete guide to all available skills | | Commands Reference | All slash commands & usage |

License

See LICENSE for details.