| name | agent-3md |
| description | Validate, route, inspect, or run agent.3md manifests and typed tool templates. |
Agent 3md
An agent.3md is executable configuration: plane 0 is identity; other planes are skills
with triggers, typed inputs, optional tool= command templates, and dependency links.
Let can locate the file; this skill validates, routes, and optionally runs it.
Install
CorvidLabs/agent-3md is not a Fledge plugin (no fledge agent3md). Use the library
or CLI below.
TypeScript library (embed):
npm install @corvidlabs/agent3md
CLI (prefer current main; crates.io may lag for run/--exec):
The Rust CLI on GitHub main supports manifest, skills, route, get, resolve,
validate, and run (--exec). Published cargo install agent3md may ship only the
inspect/validate subset—verify agent3md --help after install.
cd /path/to/agent-3md
cargo install --path loaders/rust
bun run cli --help
Inside the agent-3md repo:
| Action | Command |
|---|
| Inspect / route / run | bun run cli <cmd> … |
| Validate | bun run validate <file> (not bun run cli validate) |
| Scaffold | bun run cli new … (TS-only) |
Inspect without executing
agent3md validate agent.3md
agent3md manifest agent.3md
agent3md skills agent.3md
agent3md route agent.3md "<request>"
agent3md get agent.3md <skill-name>
agent3md resolve agent.3md <skill-name>
If validate rejects a modern manifest after cargo install agent3md from crates.io, use
repo-local bun run validate or a git/--path install of the current loader—published
crates.io 0.1.0 still requires model: in frontmatter and does not ship run/--exec.
Preview, then execute only when authorized
Confirm run exists in agent3md --help first:
agent3md run agent.3md "<request>" key=value
agent3md run agent.3md "<request>" key=value --exec
Repo-local equivalent: bun run cli run agent.3md "<request>" key=value [--exec].
Inspect the matched skill, substituted values, quoting, working directory, and referenced
paths before --exec. --exec does not bypass Fledge workflows, repository policy, the
sandbox, or external-write approval. Prefer fledge run for repository-declared tasks.
Skills without a tool= attribute are playbook-only—follow them with the host's own tools.
Use the three-md skill for general .3md documents that are not agent manifests.