moonrepo-skill

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

<p align="center">
  <img src="https://moonrepo.dev/brand/moon/icon.svg" alt="moonrepo" width="120">
</p>

<h1 align="center">
  🔮 moonrepo-skill
</h1>

<p align="center">
  <strong>AI Agent Skills for moonrepo</strong><br>
  <sub>Build systems that remember</sub>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Claude_Code-Plugin-d4a574?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Code">
  <img src="https://img.shields.io/badge/skills.sh-Compatible-e135ff?style=for-the-badge&logo=vercel&logoColor=white" alt="skills.sh">
  <img src="https://img.shields.io/badge/moon-Build_System-af63d3?style=for-the-badge&logo=moonrepo&logoColor=white" alt="moon">
  <img src="https://img.shields.io/badge/proto-Version_Manager-80ffea?style=for-the-badge&logo=rust&logoColor=black" alt="proto">
</p>

<p align="center">
  <a href="https://github.com/hyperb1iss/moonrepo-skill/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/hyperb1iss/moonrepo-skill?style=flat-square&logo=apache&logoColor=white" alt="License">
  </a>
  <a href="https://github.com/hyperb1iss/moonrepo-skill/releases">
    <img src="https://img.shields.io/github/v/release/hyperb1iss/moonrepo-skill?style=flat-square&logo=github&logoColor=white" alt="Release">
  </a>
</p>

<p align="center">
  <a href="#-installation">Installation</a> •
  <a href="#-skills">Skills</a> •
  <a href="#-commands">Commands</a> •
  <a href="#-agents">Agents</a> •
  <a href="#-compatibility">Compatibility</a>
</p>

---

## 💎 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](https://github.com/hyperb1iss/moonrepo-skill/tree/HEAD/LICENSE)

---

<p align="center">
  Created by <a href="https://hyperbliss.tech">Stefanie Jane</a>
</p>

<p align="center">
  <a href="https://github.com/hyperb1iss">
    <img src="https://img.shields.io/badge/GitHub-hyperb1iss-181717?style=for-the-badge&logo=github" alt="GitHub">
  </a>
  <a href="https://bsky.app/profile/hyperbliss.tech">
    <img src="https://img.shields.io/badge/Bluesky-@hyperbliss.tech-1185fe?style=for-the-badge&logo=bluesky" alt="Bluesky">
  </a>
</p>

🔮 moonrepo-skill

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 and 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 ecosystem.

⚡ Installation

Claude Code Plugin

# Add the marketplace
/plugin marketplace add hyperb1iss/moonrepo-skill

# Install the plugin
/plugin install moonrepo

Vercel Skills (skills.sh)

npx add-skill hyperb1iss/moonrepo-skill

Manual (Any Agent)

Copy the skills/ directory to your agent's skills location, or symlink it:

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

# 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

License

Apache-2.0 — See LICENSE

Created by Stefanie Jane