magus v0.4.3 is out. See what's new
¶ View markdown source · ✎ Suggest an edit
3 min read

Agent skills

These are the skills magus agent install writes, reproduced verbatim from the bodies embedded in the binary. Each ships in two hand-authored forms, and install writes both: the short form is the always-loaded primary, and the full form is its <name>-full twin, loaded by name when a reader needs the rationale. See Skills for the difference.

magus-architecture-reviewGather architecture evidence from the magus knowledge graph (package imports, layers, symbol callers, churn, ownership) instead of reading files.9.0 KB short, 12.2 KB full - 25% shorter magus-buzz-langWrite, fix and debug Buzz, the statically typed language of magusfile.buzz, spells and `magus buzz` scripts.9.7 KB short, 12.6 KB full - 23% shorter magus-buzz-reviewReview Buzz code - a magusfile, a spell, or a standalone .buzz script - across three lenses run in parallel: idiom/style, skeptic/correctness, and upstream-Buzz conformance.11.3 KB short, 18.7 KB full - 39% shorter magus-change-summarySummarize what changed in a magus workspace, write it up, or answer a granular diff question.3.5 KB short, 6.4 KB full - 45% shorter magus-commit-compositionRestructure an UNPUSHED branch so each commit is one reviewable idea, using the workspace's own boundaries (project ownership, declared outputs, blast radius) rather than guessing from paths.2.8 KB short, 4.3 KB full - 35% shorter magus-context-auditAudit the instructions an agent was given for statements that contradict each other or no longer match the tools.3.4 KB short, 5.8 KB full - 41% shorter magus-diagramWrite, check and view an architecture figure with magus/figure, the embedded Buzz module.5.6 KB short, 8.0 KB full - 29% shorter magus-multi-agentLoad BEFORE your first subagent spawn in a magus workspace: an Agent or Task tool call, a background worker, parallel workers, fanning out, or delegating part of a task.21.2 KB short, 28.0 KB full - 24% shorter magus-queryQuery the magus knowledge graph to find and relate entities (projects, targets, spells, ops, charms, modules, diagnostics, docs).9.0 KB short, 15.4 KB full - 41% shorter magus-runRun builds, tests, lints, and codegen through magus targets.7.7 KB short, 14.2 KB full - 45% shorter magus-sdkHelp a Go developer consume magus as a library (import "github.com/egladman/magus") instead of shelling out to the CLI, and audit whether the SDK actually serves them.9.9 KB short, 13.7 KB full - 27% shorter magus-test-designChoose unit, integration, or end-to-end test boundaries from the magus graph and runtime behavior.5.3 KB short, 10.2 KB full - 48% shorter magus-upstream-docsTraverse magus's own documentation to answer a "how does magus do X / what does Y mean / where is Z documented" question, instead of guessing an answer or a URL.2.9 KB short, 5.0 KB full - 43% shorter magus-upstream-sourceLast resort: read magus's OWN source code at the exact commit of the magus binary in use, to trace behavior its docs cannot explain.1.8 KB short, 3.1 KB full - 42% shorter magus-vcs-hygieneSafe version-control operations in a magus workspace (any repo with magusfile.buzz at the root).6.3 KB short, 11.2 KB full - 44% shorter magus-workspace-rulesAdapt magus's installed agent integration to THIS workspace without breaking it.8.3 KB short, 12.3 KB full - 32% shorter

All 16 together are 117.7 KB installed as the short form, against 181.2 KB for the full twins: 35% less always-loaded text.

agentsskillsreference
Last updated (61fd39a7)
Earlier changes on this page (7)

Full history ↗ · Blame source ↗

Glossary

Workspace

The magus root directory that owns a set of projects and shared config; the unit magus operates over. Workspace in full.

Project

A directory magus recognizes as a unit of work (it has a magusfile); the unit of caching, scheduling, and dependency tracking. Project in full.

Magusfile

The magusfile.buzz that declares a project's targets (as export funs) and binds its spells. Magusfile in full.

Target

A named operation (build, test, ...) you invoke with magus run <target>; it may compose a spell's tool-native operations and depend on other targets. Target in full.

Op

A single tool-native command a target composes (long form: operation); the middle of the work hierarchy (Spell to Op to Target). Op in full.

Spell

A language/runtime adapter (e.g. go, md) that maps generic targets onto a toolchain's real commands. Spell in full.

Charm

An execution modifier attached with : (lint:rw) that changes how a target runs, not which one; the built-in rw flips a check-only target to mutate in place, and ci always strips it. Charm in full.

Module

A magus stdlib namespace a magusfile imports for host capabilities: filesystem, exec, vcs, and more. Module in full.

Buzz

The language magusfiles are written in (the .buzz engine). Buzz in full.

Trace

OpenTelemetry's name for one whole magus invocation; every target it runs is a span beneath it. Trace in full.

Span

OpenTelemetry's name for one unit of work under a trace: a target execution, whose sub-operations are child spans. An output reference points at a span's captured output. Span in full.

Knowledge graph

The queryable graph of a workspace's spells, targets, docs, and code relationships; query it with magus query/explain/path. Knowledge graph in full.

Ownership

An insight lens for author concentration: the primary author and their share, the distinct-author count (the bus factor), and abandonment. Ownership in full.

Agent

A model working through an agent host such as Claude Code, Codex, Cursor or OpenCode. magus treats an agent as one more caller of its CLI, MCP tools and console, held to the same checks as a person. Agent in full.

Tool

An action a model can call through its host: a name, a description, a typed input and a result. magus serves its tools over MCP, each a read of the workspace model or a run of the CLI it already has. Tool in full.

Skill

A packaged set of instructions an agent host loads when a task matches its description: a directory holding a SKILL.md. magus ships its magus-* skills in the binary and writes them with magus agent install. Skill in full.

Run

One target executing under one magus invocation, such as magus run test web or magus affected ci. A run keeps its captured output behind an output reference. Every magus run is a run whether or not any job asked for it; see Job for how the two relate. Run in full.

Conventions

Placeholders

Angle brackets mark a value you replace with your own; never type the brackets:

magus run <target>
magus completion <shell>    # e.g. bash, zsh, fish

<target>, <path>, <shell>, <name> and the like are stand-ins, not literal text.