magus v0.3.0 is out. See what's new
¶ View markdown source · ✎ Suggest an edit
2 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 permutations: the default carries the rationale behind each step, and --simple withholds it. See Agents for how to choose.

skill full short saved what it is for
magus-architecture 6277 5030 19% Ground refactoring and structure proposals in the magus knowledge graph instead of intuition.
magus-buzz 7031 6024 14% Write and run Buzz, the language magusfiles, spells, and magus buzz scripts are written in.
magus-changes 5133 3863 24% Summarize what changed in a magus workspace, write it up, or answer a granular diff question.
magus-context-audit 5164 3680 28% Audit the instructions an agent was given - the repo instruction file, installed skills, handoff-journal entries, a routing index, hook-injected text, and any user-level instruction file - for statements that contradict each other or that no longer match what the tools do.
magus-delegate-ultra 8447 6404 24% Plan and execute potentially expensive multi-agent work in a magus workspace as an acceptance-criteria loop, using affected shard plans and knowledge-graph evidence to assign collision-resistant edit units, coordinate nested delegation, and choose cost-appropriate effort tiers.
magus-docs 3670 2917 20% Traverse 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.
magus-memory 3831 3156 17% Maintain a user-owned handoff journal through magus_memory or magus memory: named decisions, plans, and pointers that survive worktrees and sessions.
magus-query 7785 5576 28% Query the magus knowledge graph to find and relate entities (projects, targets, spells, ops, charms, modules, diagnostics, docs).
magus-run 9375 5604 40% Run builds, tests, lints, and codegen through magus targets.
magus-sdk 13316 12650 5% Help 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.
magus-vcs 6635 4527 31% Safe git operations in a magus workspace (any repo with magusfile.buzz at the root).
all 11 76664 59431 22%
agentsskillsreference
Last updated (a103255f)
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. See workspace.

Project

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

Magusfile

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

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. See targets.

Operation

A single tool-native command a target composes; the middle of the work hierarchy (Spell to Operation to Target). See operations.

Spell

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

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. See charms.

Module

A magus stdlib namespace a magusfile imports for host capabilities: filesystem, exec, vcs, and more. See the module reference.

Buzz

The language magusfiles are written in (the .buzz engine). See engines.

Affected

The set of projects touched by a change; magus affected <target> runs a target only over them. See affected.

CI

An ordinary magusfile-defined target you compose yourself with magus\needs - magus does not hardcode its stages. Magus.RunCI treats it specially only in that it strips the rw charm, it is the anchor magus affected ci keys off, and a selected scope with no project declaring it is a load error rather than a silent no-op. See targets.

Knowledge graph

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

Conventions

This page uses none of the site's convention markers. The full set is on the conventions page.