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)

Searching Database…

40.9K ·GitHub
这是什么?这是一个面向编码代理的多运行环境智能体构建模块市场,包含 94 个插件、202 个代理、183 项技能和 105 条命令。它们都由同一份 Markdown 源文件生成,并可被 Claude Code、Codex CLI、Cursor、OpenCode、Antigravity CLI 和 GitHub Copilot 原生调用。
这是一个能在所有工具里通用的插件,还是每个工具各有一套版本?它是一个单一事实来源的仓库(plugins/),各个运行环境的适配器会把它转换成各自原生的产物,而不是做一个所有工具共用的最小公约数式插件。
我该怎么为我的编码代理安装这些插件或技能?这取决于你使用的运行环境:Codex 和 Cursor 直接从已提交的注册表安装(指向 plugins/),Antigravity 和 OpenCode 则需要先克隆仓库并执行生成步骤。如果你只需要技能,可以跳过这些步骤,直接使用 'gh skill install wshobson/agents' 或 'npx skills add wshobson/agents'。
我得把整个仓库都克隆下来才能用吗?不一定。Codex 和 Cursor 通过已提交的注册表从源码安装,无需克隆;只安装技能时,可以通过 gh skill 或 npx skills 直接从 GitHub 获取。只有 Antigravity 和 OpenCode 需要在本地克隆仓库并使用 make。
每个插件在五种运行环境里的表现都一样吗?并不一样。每种运行环境都会获得符合自身习惯的适配版本,而不是完全相同的副本。例如,Codex 生成的技能会遵守 8 KB 的大小上限,并把命令转换为技能;OpenCode 则把权限映射到它自己的白名单系统。
它是怎么决定由哪个 AI 模型来运行每个代理的?它采用五级模型策略,按成本和复杂度分配任务:Fable 5 用于最长的自主运行任务(需主动开启,属高级功能);Opus 负责架构与安全;用户自选的模型负责后端、前端和机器学习工作;Sonnet 负责文档和测试;Haiku 负责快速的运维类任务。
插件和技能的质量是怎么检查的?内置框架 plugin-eval 会运行三层检查:免费的静态结构分析、基于 LLM 评审的语义审查(Haiku + Sonnet,覆盖四个维度),以及基于蒙特卡洛模拟的统计可靠性测试(50-100 次模拟运行)。
我能添加长期记忆或安全扫描器之类的外部工具吗?可以。Pensyve 作为 Claude Code 的外部记忆集成提供,其他运行环境也有上游集成;HOL Guard 则作为经过审核的外部安全集成提供,并暴露 hol-guard 和 plugin-scanner 两项技能。
Creator
wshobson
Size
4.5 MB
Stars
40.9K
Updated
CommitOct 15
Age
1y
Commits · 90 Days