agents README

The project's README from github.com/wshobson/agents. As one markdown file: README.md.

Agentic Plugin Marketplace

Production-ready agentic workflow building blocks: 94 plugins, 202 agents, 183 skills, 105 commands — built for Claude Code and consumed natively by OpenAI Codex CLI, Cursor, OpenCode, the Antigravity CLI, and GitHub Copilot from a single Markdown source.

Claude Code Codex CLI Cursor OpenCode Antigravity CLI Copilot

[!NOTE] One source-of-truth (plugins/), five harnesses. Each harness gets idiomatic, harness-native artifacts — not lowest-common-denominator translations. See docs/harnesses.md for the capability matrix.

Quick start

Pick your harness:

Claude Code

/plugin marketplace add wshobson/agents
/plugin install python-development          # or any of 94 plugins

→ Full Claude Code setup, troubleshooting, and plugin catalog

Codex CLI · Cursor · OpenCode · Antigravity CLI · Copilot

Codex and Cursor install natively from the committed registries (which point at the source plugins/):

npx codex-marketplace add wshobson/agents        # Codex; then install individual plugins
# Cursor: add the marketplace, then `/plugin install <name>` (reads .cursor-plugin/ + source)

Antigravity and OpenCode install via clone + generate (the transformed trees are gitignored):

gh repo clone wshobson/agents ~/agents && cd ~/agents
make generate HARNESS=antigravity && make install-antigravity  # Antigravity (agy)
make install-opencode                                          # OpenCode (runs generate + symlinks)

Skills only: gh skill · npx skills

Both Agent Skills installers read plugins/*/skills/ straight from GitHub, into whichever agent you use. No clone, no marketplace, no generate step. Skills only: no agents, commands, or hooks.

gh skill install wshobson/agents                                 # browse, then pick a skill or --all
gh skill install wshobson/agents python-testing-patterns --agent claude-code
npx skills add wshobson/agents --skill python-testing-patterns   # add -a claude-code, -g for user scope

Setup details and per-harness gotchas: docs/harnesses.md.

What's inside

Count What it is
Plugins 94 Granular, single-purpose installable units (92 local + 2 external via git-subdir)
Agents 202 Domain experts (architecture, languages, infra, security, data, ML, docs, business, SEO)
Skills 183 Modular knowledge packages with progressive disclosure (load when activated)
Commands 105 Slash commands: scaffolding, security scans, test gen, infrastructure setup
Orchestrators 16 Multi-agent coordination workflows (full-stack, security, ML, incident response)

Browse the catalog: docs/plugins.md · docs/agents.md · docs/agent-skills.md

How it works

Each plugin is isolated and composable: agents, commands, and skills are auto-discovered from directory structure. Installing a plugin loads only its components into context — not the whole marketplace.

plugins/python-development/
├── .claude-plugin/plugin.json
├── agents/             # 3 Python agents (python-pro, django-pro, fastapi-pro)
├── commands/           # 1 scaffolding command
└── skills/             # 16 specialized skills (async, testing, packaging, …)

Tiered model strategy:

Tier Model Use
0 Fable 5 Longest-horizon autonomous work — large migrations, multi-hour runs (opt-in, premium cost)
1 Opus Architecture, security, code review, production-critical
2 inherit User-chosen — backend, frontend, AI/ML, specialized
3 Sonnet Docs, testing, debugging, API references
4 Haiku Fast operational tasks, SEO, deployment, content

→ Model configuration details

Multi-harness support

This marketplace ships to five agentic harnesses from one Markdown source. Each adapter emits harness-native artifacts (not lowest-common-denominator translations):

Harness Generates Notes
Claude Code (source-of-truth) Native marketplace.json + plugins/
Codex CLI .agents/plugins/marketplace.json + plugins/*/.codex-plugin/plugin.json (committed); .codex/skills/, .codex/agents/ (gitignored) 8 KB skill cap respected; commands → skills
Cursor .cursor-plugin/, .cursor/rules/ Thin marketplace + curated rules; reuses .claude/
OpenCode .opencode/agents/, .opencode/commands/, .opencode/skills/ permission: block from tools: allowlist; OpenCode-safe skill names
Antigravity CLI .antigravity/plugins/<p>/{skills/,agents/,commands/} Self-contained agy plugin per source plugin; model tier alias (inherit/flash/pro)
Copilot .copilot/agents/, .copilot/skills/, .copilot/commands/ Markdown agent profiles + SKILL.md skills + commands-as-skills; model maps to native Claude models 
make generate-all                        # all five
make validate                            # structural checks
make garden                              # drift / dead-link / cap detection

Codex and Cursor install from source via committed registries; Antigravity and OpenCode install via clone + make. Individual skills install into any agent with gh skill install wshobson/agents or npx skills add wshobson/agents, no clone needed.

→ Full capability matrix and per-harness deep-dives

Quality evaluation

plugin-eval is a three-layer evaluation framework for measuring and certifying plugin/skill quality:

uv run plugin-eval score path/to/skill --depth quick
uv run plugin-eval certify path/to/skill

→ PluginEval framework documentation

Documentation map

Detail lives in docs/. Read in this order:

Harness setup, capability deltas, and gotchas live in docs/harnesses.md.

Contributing: CONTRIBUTING.md · Authoring: docs/authoring.md

External Memory Integration

Pensyve is included as an external git-subdir entry for Claude Code. Pensyve also maintains direct upstream integrations for Codex CLI, Cursor, OpenCode, and Copilot (not yet Antigravity CLI).

Harness Pensyve integration
Claude Code /plugin install pensyve from this marketplace (integrations/claude-code)
Codex CLI integrations/codex-plugin
Cursor integrations/cursor
OpenCode integrations/opencode-plugin
Copilot .copilot/ in repo root or ~/.copilot/ via make install-copilot

External Security Integration

HOL Guard is included as an external git-subdir entry for Claude Code from the reviewed distributions/wshobson-agents payload in hashgraph-online/hol-guard-plugin. The payload exposes local hol-guard and plugin-scanner skills. Guard Cloud is neither required nor promoted on the default path. This marketplace entry is a Claude Code discovery surface only; it does not add HOL Guard to this repository's generated Codex, Cursor, OpenCode, Antigravity, or Copilot registries.

The reviewed external payload is pinned to commit 43b2dda59e9f07057c52e69fd7426188faae1488. Its local CLI pins are hol-guard==2.2.119 and plugin-scanner==2.2.119, and installation requires user approval. For a reviewed payload update, the marketplace sha and the matching marketplace/external manifest versions must be advanced together. When protection is explicitly requested, the external hol-guard runtime can modify supported harness hook/settings configuration; those changes are performed by the local Guard CLI, not by files in this marketplace repository.

License

MIT — see LICENSE.

Star history

Star History Chart

agents (wshobson/agents)

agent-orchestration
Searching Database…

41K ·GitHub
Agents
What is this?A multi-harness marketplace of agentic building blocks for coding agents: 94 plugins, 202 agents, 183 skills, and 105 commands built from a single Markdown source and consumed natively by Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, and GitHub Copilot.
Is this one plugin that works everywhere, or separate versions per tool?It's one source-of-truth repo (plugins/) that each harness adapter transforms into its own native artifacts, instead of a single lowest-common-denominator plugin shared by all tools.
How do I install these plugins or skills for my coding agent?It depends on your harness: Codex and Cursor install straight from the committed registries pointing at plugins/, Antigravity and OpenCode require a clone plus a generate step, and if you only want the skills you can skip all of that with 'gh skill install wshobson/agents' or 'npx skills add wshobson/agents'.
Do I need to clone the whole repo to use it?Not necessarily. Codex and Cursor install from source via the committed registries without cloning, and skills-only installs via gh skill or npx skills fetch directly from GitHub; only Antigravity and OpenCode require a local clone plus make.
Does every plugin behave identically across all five harnesses?No, each harness gets its own idiomatic adaptation rather than an identical copy — for example Codex's generated skills respect an 8 KB size cap and turn commands into skills, while OpenCode maps permissions to its own allowlist system.
How does it decide which AI model runs each agent?A five-tier model strategy assigns work by cost and complexity: Fable 5 for the longest autonomous runs (opt-in, premium), Opus for architecture and security, user-chosen models for backend/frontend/ML work, Sonnet for docs and testing, and Haiku for fast operational tasks.
How is plugin and skill quality checked?A built-in framework called plugin-eval runs three layers of checks: free static structural analysis, an LLM-judge semantic review (Haiku + Sonnet) across four dimensions, and Monte Carlo statistical reliability testing over 50-100 simulated runs.
Can I add external tools like long-term memory or a security scanner?Yes — Pensyve ships as an external memory integration for Claude Code (and has upstream integrations for the other harnesses), and HOL Guard is available as a reviewed external security integration exposing hol-guard and plugin-scanner skills.
What are similar projects?pstack-claude, planning-with-files, superpowers-zh, Orbital, operator-memory, claude-plugins-official, visual-explainer, Claude-Code-Game-Studios
Which topics is it in?cursor-rules, pi-coding-agent, subagents, marketplace, antigravity, claude-code-plugin, github-copilot, agent-skill, harness, opencode, coding-agents, claude-skills
Creator
wshobson
Size
4.5 MB
Stars
41K
Updated
CommitOct 17
Age
1y
Commits · 90 Days