repo sources instructions / skills / tools / hooks / agents

generated state registries / docs / install scripts / sync plans

runtime projections Codex / Claude Code / OpenCode / Cursor / Grok

wagents

Version agent instructions, skills, tools, hooks, and agents once; project them into every supported runtime.

Install System Overview

Surface Map

A surface is a portable piece of agent configuration. wagents keeps each surface inspectable in the repo, then generates the runtime-specific files and docs around it.

01InstructionsShared operating rules and platform overlays.02Skills678 catalog entries: 69 repo-owned, 609 curated external.03Tools65 MCP tools plus CLI and plugin surfaces.04HooksLifecycle guards, context injectors, and stop gates.05Agents20 repo-managed specialist agent definitions.

Runtime Matrix

Runtimes consume the same surfaces through native files, generated projections, plugins, MCPHub endpoints, or Skills CLI installs. The detailed fixture-backed matrix lives in Runtimes and Harness Support.

Runtime	Instructions	Skills	Tools	Hooks	Agents
Codex	generated	plugin/Skills CLI	MCPHub	generated	dynamic
Claude Code	native import	plugin/Skills CLI	MCP	generated	native subagents
OpenCode	native AGENTS.md	Skills CLI	MCPHub + plugins	generated	native agents
Cursor	rules + AGENTS.md	Skills CLI	MCPHub	native hooks	`.cursor/agents`
Grok Build	generated	mirrored skills	MCPHub	generated	delegation

9 Supported Runtimes20 Agent Definitions16 Repo MCP49 External MCP

Install Paths

Choose the path by intent; each route links to the exact commands and generated references.

use everything

Install the full catalog

Put the repo-owned skill bundle into supported agent runtimes.

install one surface

Start with one skill

Install a focused workflow first, then expand once it proves useful.

sync a runtime

Preview harness reconciliation

Use dry-run sync before changing local agent installations.

preview changes

Validate generated surfaces

Regenerate docs, validate registries, and run focused tests.

npx skills add github:wyattowalsh/agents --all -y -g --agent antigravity --agent claude-code --agent codex --agent crush --agent cursor --agent gemini-cli --agent github-copilot --agent grok --agent opencode

Install GuideIntent-based install paths and preview commands.

Skill Install ScriptsCopyable per-skill install commands.

CLI ReferenceFull wagents command reference.

Featured Workflows

Workflow cards are grouped by the surface they exercise so the catalog stays connected to the system model.

Instructions: set shared rulesRead how global instructions, platform overlays, and generated mirrors compose.

Skills: review codeRun evidence-first review with severity, risk, and validation expectations.

Skills: create MCP serversBuild a FastMCP server with design, testing, and deployment guidance.

Tools: inspect MCP control planeReview MCPHub groups, registry sources, and client sync coverage.

Hooks: enforce stop gatesUse lifecycle hooks for validation evidence and completion checks.

Agents: delegate reviewsUse specialist agent definitions for focused review and coordination roles.