moon

Configure and orchestrate Moon monorepo workspaces, tasks, and toolchains.

5|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/hyperb1iss/moonrepo-skill --skill moon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moon
Source: https://github.com/hyperb1iss/moonrepo-skill/tree/main/skills/moon
Command: npx skills add https://github.com/hyperb1iss/moonrepo-skill --skill moon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Moon configuration and orchestration across workspace, tasks, and toolchains for polyglot monorepos.

Core Features & Use Cases

  • Centralized project and workspace configuration references for moon.yml and .moon/workspace.yml
  • Task definitions, caching strategies, and toolchain management across multiple projects
  • Migration guidance to Moon v2 and practical examples for common monorepo workflows
  • Use Case: Set up a multi-project workspace and run a cross-project build with moon run :build

Quick Start

Start by inspecting an example Moon workspace and running a simple task:

  • Copy the provided examples/moon.yml into your project as moon.yml
  • Run: moon run :build

Frequently Asked Questions about moon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a monorepo with Moon?

Moon monorepos are configured through moon.yml and .moon/workspace.yml files. Define projects, tasks, and toolchains centrally to orchestrate builds and commands across your workspace. Start by copying an example moon.yml into your project root.

Can I run cross-project tasks in a Moon monorepo?

Yes. Moon supports cross-project commands using the syntax moon run :taskname, which executes tasks across multiple projects simultaneously. This enables unified builds, tests, and deployments across your entire workspace.

What's the best way to migrate to Moon v2?

Moon v2 migration is guided within the Skill through practical examples and configuration references. Review the migration documentation provided, update your workspace.yml and moon.yml structure, and test cross-project commands to verify the transition.

How do I manage toolchains across multiple projects in a monorepo?

Toolchain management in Moon is centralized through workspace configuration. Define tool versions, runtime settings, and task execution strategies once in .moon/workspace.yml, and they apply consistently to all projects without per-project duplication.

Does Moon support caching strategies for monorepo tasks?

Yes. Moon includes built-in task caching strategies within its configuration. Define caching rules in task definitions to avoid redundant builds and reduce execution time across your monorepo's projects.

Can I use Moon for polyglot monorepos with multiple languages?

Moon is designed for polyglot monorepos. It orchestrates workspaces, projects, and tasks across multiple languages and toolchains through unified configuration, enabling consistent builds regardless of project technology stack.