AI Agent Skills for moonrepo
Build systems that remember
Installation โข Skills โข Commands โข Agents โข Compatibility
--- ## ๐ What This Is **moonrepo-skill** gives your AI coding agents deep knowledge of [moon](https://moonrepo.dev/moon) and [proto](https://moonrepo.dev/proto)โthe polyglot monorepo build system and multi-language version manager. Instead of agents fumbling through docs or hallucinating configs, they get: - **Complete configuration references** for workspace, tasks, and toolchains - **v2 migration guidance** with breaking changes documented - **Real examples** from production setups - **Slash commands** for common workflows Works with Claude Code, Cursor, GitHub Copilot, Gemini CLI, and any agent supporting the [skills.sh](https://skills.sh) ecosystem. ## โก Installation ### Claude Code Plugin ```bash # Add the marketplace /plugin marketplace add hyperb1iss/moonrepo-skill # Install the plugin /plugin install moonrepo ``` ### Vercel Skills (skills.sh) ```bash npx add-skill hyperb1iss/moonrepo-skill ``` ### Manual (Any Agent) Copy the `skills/` directory to your agent's skills location, or symlink it: ```bash git clone https://github.com/hyperb1iss/moonrepo-skill.git ln -s moonrepo-skill/skills ~/.claude/skills/moonrepo ``` ## ๐ฎ Skills Skills are contextual knowledge that agents invoke when relevant. | Skill | Triggers On | What It Provides | | --------- | ------------------------------------------ | ------------------------------------------------------------------ | | **moon** | `moon.yml`, workspace config, task setup | Complete moon v2 configuration, task inheritance, CI patterns | | **proto** | `.prototools`, version management, plugins | Multi-language version pinning, plugin development, exec workflows | ### moon Skill Covers the full moon ecosystem: - **Workspace configuration** โ Project discovery, VCS settings, runner options - **Task configuration** โ Commands, scripts, inputs/outputs, caching, inheritance - **Toolchain setup** โ Node.js, Bun, Deno, Rust, Go, Python configuration - **CI/CD patterns** โ GitHub Actions, affected detection, parallelization - **v2 migration** โ Breaking changes from v1, renamed fields, new features ### proto Skill Covers proto version management: - **Core commands** โ install, pin, run, exec, outdated, clean - **Configuration** โ `.prototools` format, version specifiers, settings - **Plugin system** โ TOML and WASM plugins, development workflow - **Build from source** โ Compiling tools when pre-built unavailable - **Integration** โ moon toolchain backend, CI setup ## ๐ช Commands Slash commands for common workflows: | Command | Description | | ------------------------- | ------------------------------------------- | | `/moonrepo:moon-init` | Initialize moon workspace with guided setup | | `/moonrepo:moon-run` | Execute moon tasks with target syntax help | | `/moonrepo:moon-query` | Query projects and tasks with MQL | | `/moonrepo:proto-install` | Install and configure tools via proto | | `/moonrepo:proto-pin` | Pin tool versions for team consistency | ## ๐ฆ Agents Specialized subagents for complex tasks: | Agent | Purpose | | --------------------------- | ------------------------------------------------- | | **moon-workspace-analyzer** | Analyze monorepo structure, suggest optimizations | | **moon-task-creator** | Generate task configurations from requirements | | **proto-setup** | Bootstrap proto for new projects | ## ๐ฆ What's Included ``` moonrepo-skill/ โโโ .claude-plugin/ โ โโโ plugin.json # Claude Code manifest โ โโโ marketplace.json # Distribution index โโโ skills/ โ โโโ moon/ โ โ โโโ SKILL.md # Core moon knowledge โ โ โโโ references/ # Detailed config docs โ โ โโโ examples/ # Real configurations โ โโโ proto/ โ โโโ SKILL.md # Core proto knowledge โ โโโ references/ # Config & command docs โ โโโ examples/ # Example .prototools โโโ commands/ # Slash commands โโโ agents/ # Subagent definitions โโโ AGENTS.md # skills.sh compatibility ``` ## ๐ Compatibility This plugin works with multiple AI agent platforms: | Platform | Installation Method | | ------------------ | ----------------------------------------------------- | | **Claude Code** | `/plugin install moonrepo` | | **Cursor** | `npx add-skill hyperb1iss/moonrepo-skill -a cursor` | | **GitHub Copilot** | `npx add-skill hyperb1iss/moonrepo-skill -a copilot` | | **Gemini CLI** | `npx add-skill hyperb1iss/moonrepo-skill -a gemini` | | **Amp** | `npx add-skill hyperb1iss/moonrepo-skill -a amp` | | **Opencode** | `npx add-skill hyperb1iss/moonrepo-skill -a opencode` | ## ๐งช Development ```bash # Clone the repo git clone https://github.com/hyperb1iss/moonrepo-skill.git cd moonrepo-skill # Lint markdown make lint # Format markdown make format # Test locally with Claude Code claude --plugin-dir . ``` ## ๐ Resources - [moon documentation](https://moonrepo.dev/docs/moon) - [proto documentation](https://moonrepo.dev/docs/proto) - [moonrepo GitHub](https://github.com/moonrepo/moon) - [Claude Code plugins](https://docs.anthropic.com/en/docs/claude-code/plugins) - [skills.sh ecosystem](https://skills.sh) ## License Apache-2.0 โ See [LICENSE](LICENSE) ---Created by Stefanie Jane
