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 КБ и превращают команды в скиллы, а OpenCode сопоставляет права доступа со своей собственной системой белых списков (allowlist).
Как выбирается, какая ИИ-модель запускает каждого агента?Пятиуровневая стратегия распределяет задачи по стоимости и сложности: Fable 5 для самых долгих автономных запусков (включается по желанию, премиум), Opus для архитектуры и безопасности, модели по выбору пользователя для задач бэкенда, фронтенда и ML, 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