moonbit-agent-guide

Guide AI agents to write, refactor, and test MoonBit projects with moon tooling.

74|11|Updated Sep 15, 2025
One-click install
npx skills add https://github.com/moonbitlang/moonbit-agent-guide --skill moonbit-agent-guide-moonbitlang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moonbit-agent-guide
Source: https://github.com/moonbitlang/moonbit-agent-guide/tree/main/moonbit-agent-guide
Command: npx skills add https://github.com/moonbitlang/moonbit-agent-guide --skill moonbit-agent-guide-moonbitlang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured guide for writing, refactoring, and testing MoonBit projects, helping teams organize MoonBit files, leverage moon tooling, and align with MoonBit conventions.

Core Features & Use Cases

  • Project organization: standardizes module and package layouts, moon.mod.json, and moon.pkg configurations to keep MoonBit codebases tidy.
  • Tooling guidance: explains how to use moon check, moon build, moon test, and moon info for rapid validation and documentation.
  • Workflow automation: outlines reproducible agent workflows for editing, packaging, and validating MoonBit code in real projects.
  • Use Case: imagine a moon-based project with multiple packages; this guide shows how to navigate module boundaries and apply consistent practices across packages.

Quick Start

Use the guide to kick off a MoonBit project workflow by running the canonical Agent Workflow steps in order: clarify goals, locate module boundaries, discover APIs with moon ide, refactor with moon rename, and validate with moon check and moon test.

Frequently Asked Questions about moonbit-agent-guide

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

FAQPage Schema
How do I structure a MoonBit project with multiple packages and modules?

MoonBit project organization standardizes module and package layouts using moon.mod.json and moon.pkg configurations. This keeps multi-package codebases tidy and ensures agents navigate module boundaries consistently across the project.

What's the best workflow for an AI agent to refactor MoonBit code?

A canonical MoonBit agent workflow runs steps sequentially: clarify goals, locate module boundaries, discover APIs with moon ide, refactor with moon rename, then validate using moon check and moon test for reproducible code changes.

Which Moon CLI commands do I need to validate and test MoonBit projects?

MoonBit tooling validation relies on moon check, moon build, moon test, and moon info commands. These tools execute rapid validation, build artifacts, run tests, and generate documentation for standard project workflows.

Do I need Moon CLI installed to use MoonBit project workflows?

Yes, MoonBit workflows require Moon CLI installed and standard validation steps to execute. The environment setup provides build, check, run, test, and doc tooling capabilities necessary for agent-driven project automation.

Can I use Moon IDE features for navigating MoonBit module boundaries?

Yes, MoonBit tooling includes moon ide guidance for discovering APIs within module boundaries. Agents leverage this to navigate multi-package projects and apply consistent practices across interconnected modules during refactoring.

Why does MoonBit project organization need standardized moon.pkg configurations?

MoonBit package configurations via moon.pkg files define module boundaries and dependencies. Standardizing these configurations prevents layout issues and maintains tidy codebases when agents edit or restructure multiple packages.