metagent

metagent is a standalone Agent Skills package for building other agents.

Use it when you want your coding agent to:

• design a new agent, subagent, or assistant
• choose between a script, prompted app, tool-calling agent, multi-step agent, or MAS
• review prompt, tool, memory, guardrail, or eval architecture
• turn a rough agent idea into an implementation-ready plan

Contents

This repository is intentionally small and self-contained:

• SKILL.md — the top-level router for the skill
• handbook.md — design guidance and architecture principles
• examples.md — reusable implementation patterns and anti-patterns
• rules.md — review gates and quality checks

Install

This repository is shaped as a standalone skill package: SKILL.md lives at the repository root.

To install it, clone this repository into a skill directory named metagent.

Claude Code

Global install:

mkdir -p ~/.claude/skills
git clone https://github.com/chistopat/metagent.git ~/.claude/skills/metagent

Project-local install:

mkdir -p .claude/skills
git clone https://github.com/chistopat/metagent.git .claude/skills/metagent

Codex

Global install:

mkdir -p ~/.codex/skills
git clone https://github.com/chistopat/metagent.git ~/.codex/skills/metagent

Project-local install:

mkdir -p .codex/skills
git clone https://github.com/chistopat/metagent.git .codex/skills/metagent

Warp

Warp scans several skill directories. The recommended cross-client location is .agents/skills/.

Global install:

mkdir -p ~/.agents/skills
git clone https://github.com/chistopat/metagent.git ~/.agents/skills/metagent

Project-local install:

mkdir -p .agents/skills
git clone https://github.com/chistopat/metagent.git .agents/skills/metagent

Warp also discovers skills from .warp/skills/, .claude/skills/, .codex/skills/, and other supported skill directories.

Optional skills CLI

If you use the skills installer, you can also try:

npx skills add chistopat/metagent --agent claude-code

npx skills add chistopat/metagent --agent codex

Use

Start a new session in your agent after installing the skill, then invoke it naturally:

• use metagent to design an agent for support triage
• use metagent to review this multi-agent architecture
• use metagent to turn this idea into an implementation package

If your client supports direct skill invocation, /metagent should also work.

In Warp, local agents can also be started from a fully qualified skill reference:

oz agent run --skill "chistopat/metagent:metagent" --prompt "design an agent for support triage"

Update

Pull the latest version in whichever location you installed it:

git -C ~/.claude/skills/metagent pull --ff-only
git -C ~/.codex/skills/metagent pull --ff-only
git -C ~/.agents/skills/metagent pull --ff-only

License

MIT