# Agent 3md

> Validate, route, inspect, or run agent.3md manifests and typed tool templates.

- Skill: `corvidlabs/agent-3md` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add corvidlabs/agent-3md`
- Raw SKILL.md: https://api.skillmd.com/api/skills/corvidlabs/agent-3md/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: CorvidLabs (https://skillmd.com/u/corvidlabs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/corvidlabs/agent-3md

---


# 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):

```sh
npm install @corvidlabs/agent3md
# or: bun add @corvidlabs/agent3md
```

**CLI** (select a supported release with the capabilities the task needs):

Inspect `agent3md --help` for `manifest`, `skills`, `route`, `get`, `resolve`,
`validate`, and `run` (`--exec`). Package-manager builds may lag the supported release;
check current upstream release guidance before choosing an install source.

```sh
# From a clone of CorvidLabs/agent-3md
cd /path/to/agent-3md
cargo install --path loaders/rust
# or without a global install:
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

```sh
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
the compatible repo-local validator or a supported loader release. Do not add obsolete
manifest fields merely to satisfy an older validator.

## Preview, then execute only when authorized

Confirm `run` exists in `agent3md --help` first:

```sh
# Route + fill tool template; print the command (does not run it)
agent3md run agent.3md "<request>" key=value

# Run the rendered command
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.