CLAUDE_SKILL.md raw

Moxie Claude Code Skill

A Claude Code skill that teaches Claude the Moxie language - compile errors, type system, execution model, spawn boundary, memory management, and build tooling.

Install

Copy the skill directory to your Claude Code skills location:

cp -r docs/claude-skill/moxie ~/.claude/skills/moxie

This installs system-wide for your user. The skill activates automatically when Claude detects .mx files or Moxie-related discussion.

Structure

moxie/
  SKILL.md                       # top-level: compile errors, core rules, quick ref
  references/
    type-system.md               # numeric types, string=[]byte, builtin stringers, interfaces
    execution-model.md           # domains, spawn, IPC channels, Codec, fan-out pattern
    memory-management.md         # per-function arena ownership, FnArenaPush/Pop, relocate on return
    syntax-quick-ref.md          # operators, literals, keywords, removed constructs
    build-and-modules.md         # build commands, targets, moxie.mod, cache, .mxh headers
    wasm-target.md               # string pragma, JS bridge packages, crypto
    formatting.md                # moxiefmt rules, 80-col single-line, tab indentation

Update

When the language changes, edit the files in ~/.claude/skills/moxie/ directly. The canonical source is in this repo at docs/claude-skill/moxie/.