MoiCle

Reusable AI agents, commands, skills, and architecture references for Claude Code

If you find this project useful, please consider giving it a ⭐ on GitHub!

A toolkit to bootstrap and accelerate project development with Claude Code through specialized agents, automation commands, workflow skills, and unified architecture references.

Features

• 18 AI Agents - 6 developer agents + 12 utility agents
• 2 Commands - Wizards for project bootstrap and go-to-market planning
• 10 Skills - Mode-based, auto-triggered workflows for the full SDLC (feature, bug, review, research, docs, marketing) plus standalone /challenge (self-critique) and /cleanup (dead-code/duplicate)
• 9 Architecture References - DDD + Hexagonal + stack-specific patterns

Current Support

• [x] Claude
• [x] Codex CLI
• [x] Antigravity
• [x] Cursor
• [x] Devin CLI
• [x] Windsurf

Older MoiCle versions merged agents into ~/.cursor/AGENTS.md. Re-run moicle install --target cursor for native .cursor/rules/*.mdc layout; you may delete legacy AGENTS.md manually.

Upgrading & stale items

moicle upgrade bumps the npm package only — items already installed in ~/.claude/ (or ./.claude/, .cursor/…) stay untouched. When a MoiCle release removes an asset (e.g. a skill or command deleted from the package), the leftover files remain active in your editor until removed.

Starting with this release, moicle install writes a .moicle-manifest.json into the target dir recording exactly what it placed. moicle uninstall removes everything in that manifest — including items the newer package no longer ships — while leaving your own files alone:

# Clean upgrade path
moicle uninstall && moicle install

Leftovers from pre-manifest versions (< this release) aren’t tracked — remove them manually if needed, e.g. ~/.claude/commands/doc.md, ~/.claude/skills/feature-track/.

Installation

npm install -g moicle

Quick Start

# Install agents, commands, skills, architecture
moicle install

# Install for Codex CLI
moicle install --target codex --global

# Install for Antigravity
moicle install --target antigravity --global

# Install for Cursor (rules, commands, skills, architecture)
moicle install --target cursor --global
moicle install --target cursor --project

# Choose:
# 1. Pick Claude Code, Codex CLI, or Antigravity
# 2. Pick global or project scope

CLI Commands

What’s Included

Architecture References (9)

Developer Agents (6)

Utility Agents (12)

Commands (2)

Skills (10)

Skills are grouped by a - prefix. Type /- then Tab in Claude Code to see all skills in a group. Each skill bundles several related workflows into modes chosen at the top of the file — pick a mode (or let Claude pick it from your natural-language phrasing). Two skills — /challenge and /cleanup — are intentionally standalone (no group prefix).

/feature-* — Build & Change

/fix-* — Bugs & Incidents

/review-* — Review & Quality

/research-* — Explore & Learn

/docs-* — Project Documentation

/marketing-* — Brand & Content (wrapped by the /marketing command)

/challenge — Self-Critique (standalone, no group)

/cleanup — Dead Code & Duplicate (standalone, no group)

Skill decision matrix

When more than one skill / mode could fit, use this matrix:

Backward compatibility

The 22 original skills were consolidated into 10 mode-based skills. Old trigger phrases still work — they’re kept in each skill’s description so Claude auto-invokes the right skill and the right mode when the user says e.g. “deep debug” (→ /fix-bug DEEP), “hotfix” (→ /fix-bug QUICK), “review changes” (→ /review-code SELF). The flattened name /group-action is the explicit invocation form.

Architecture-First Approach

All agents reference architecture files to ensure consistency:

~/.claude/
├── agents/
├── commands/
├── skills/
└── architecture/          # Architecture references
    ├── ddd-architecture.md
    ├── flutter-mobile.md
    ├── go-backend.md
    ├── hexagonal-architecture.md
    ├── laravel-backend.md
    ├── monorepo.md
    ├── nodejs-nestjs.md
    ├── react-frontend.md
    ├── remix-fullstack.md
    └── _shared/           # read-project-first, engineering-principles, stack-detection, severity-levels

When an agent is invoked, it reads the architecture file first before coding according to the defined structure.

For Codex CLI, MoiCle installs architecture docs into ~/.codex/architecture or ./.codex/architecture, and converts MoiCle agents, commands, and existing skills into native Codex skills under .codex/skills. Restart Codex after a global install so the new skills are loaded.

For Antigravity, MoiCle installs architecture docs into ~/.gemini/architecture or ./.gemini/architecture, and converts MoiCle agents, commands, and existing skills into native Antigravity skills under .gemini/skills.

For Devin CLI, MoiCle installs agents as native subagent profiles into ~/.config/devin/agents or ./.devin/agents, converts commands and skills into native Devin skills under ~/.config/devin/skills or ./.devin/skills, and installs architecture docs into /architecture. Ask Devin to use a profile by name (e.g. “review with the code-reviewer subagent”) or invoke skills with /skill-name.

Usage Examples

Using Commands

# Bootstrap new project
/bootstrap                              # Interactive wizard
/bootstrap go                           # Quick start with Go + Gin
/bootstrap react                        # Quick start with React + Vite
/bootstrap flutter                      # Quick start with Flutter
/bootstrap landing using monorepo       # Create landing page with monorepo structure

# Go-to-market plan
/marketing                              # Unified brand + video + content plan

Using Agents

# Agents will automatically read architecture reference before coding
@go-backend-dev Implement user authentication module
@react-frontend-dev Create dashboard page with charts
@clean-architect Review this PR's architecture

Enable/Disable Agents

# Disable unused agents
moicle disable @rust-dev
moicle disable @swift-ios-dev

# Enable again
moicle enable @rust-dev

# View status
moicle status

Project Structure

claude-agents-kit/
├── bin/
│   └── cli.js
├── src/
│   ├── commands/
│   │   ├── install.js
│   │   ├── uninstall.js
│   │   ├── list.js
│   │   ├── enable.js
│   │   ├── disable.js
│   │   └── status.js
│   └── utils/
│       ├── symlink.js
│       └── config.js
├── assets/
│   ├── agents/
│   │   ├── developers/
│   │   └── utilities/
│   ├── architecture/        # Architecture references
│   ├── commands/
│   └── skills/
├── package.json
└── README.md

Requirements

• Node.js >= 18.0.0
• Claude Code CLI

Donate

If you find this project useful, consider buying me a coffee!

USDT / ETH / BNB:

0xf3b2a531cb2774c77a751cdb10e043992eff5a2c

License

GPL-3.0