How wshobson/agents works
This repository packages shared agents, skills, and commands for multiple AI coding harnesses. Its main workflow is to maintain plugin components in a common Markdown-based source, then expose them natively or generate harness-specific artifacts through adapters. A separate plugin-eval tool parses and scores skills. The README documents capabilities beyond the sampled code, including native marketplace routes and experimental LLM evaluation; those documented branches are represented without assuming unsampled implementation details. Edges reflect README statements or SOURCE INDEX references, which do not establish every runtime detail.
Main entry points: generate.py Generation CLI · base.py Source models · engine.py Evaluation engine · capabilities.py Harness capabilities
Components 25
Shared components
- Plugin components
plugins - Native marketplaces
Harness generation
- Generation CLI
tools/generate.py - Source models
tools/adapters/base.py - Harness capabilities
tools/adapters/capabilities.py - Codex adapter
tools/adapters/codex.py - Cursor adapter
tools/adapters/cursor.py - OpenCode adapter
tools/adapters/opencode.py - Copilot adapter
tools/adapters/copilot.py - Antigravity adapter
tools/adapters/antigravity.py - Pi adapter
tools/adapters/pi.py
Plugin evaluation
- Evaluation CLI
plugins/plugin-eval/src/plugin_eval/cli.py - Evaluation engine
plugins/plugin-eval/src/plugin_eval/engine.py - Evaluation models
plugins/plugin-eval/src/plugin_eval/models.py - Skill parser
plugins/plugin-eval/src/plugin_eval/parser.py - Result reporter
plugins/plugin-eval/src/plugin_eval/reporter.py - Evaluation corpus
plugins/plugin-eval/src/plugin_eval/corpus.py
Evaluation layers
- Static analysis
plugins/plugin-eval/src/plugin_eval/layers/static.py - Harness portability
plugins/plugin-eval/src/plugin_eval/layers/harness_portability.py - LLM judge
plugins/plugin-eval/src/plugin_eval/layers/judge.py - LLM SDK helper
plugins/plugin-eval/src/plugin_eval/layers/_sdk.py - Monte Carlo
plugins/plugin-eval/src/plugin_eval/layers/monte_carlo.py - Evaluation statistics
plugins/plugin-eval/src/plugin_eval/stats.py
Other components
- Plugin maintainer
- Coding harnesses
Connections 45
- Plugin maintainer → Plugin components: authors
README.md - Plugin components → Native marketplaces: feeds native installs
README.md - Native marketplaces → Coding harnesses: installs components
README.md - Plugin maintainer → Generation CLI: runs generation
README.md - Generation CLI → Plugin components: reads source
tools/generate.py - Generation CLI → Codex adapter: dispatches
tools/generate.py - Generation CLI → Cursor adapter: dispatches
tools/generate.py - Generation CLI → OpenCode adapter: dispatches
tools/generate.py - Generation CLI → Copilot adapter: dispatches
tools/generate.py - Generation CLI → Antigravity adapter: dispatches
tools/generate.py - Generation CLI → Pi adapter: dispatches
tools/generate.py - Codex adapter → Source models: uses
tools/adapters/codex.py - Cursor adapter → Source models: uses
tools/adapters/cursor.py - OpenCode adapter → Source models: uses
tools/adapters/opencode.py - Copilot adapter → Source models: uses
tools/adapters/copilot.py - Antigravity adapter → Source models: uses
tools/adapters/antigravity.py - Pi adapter → Source models: uses
tools/adapters/pi.py - Source models → Harness capabilities: reads capabilities
tools/adapters/base.py - Codex adapter → Harness capabilities: uses capabilities
tools/adapters/codex.py - OpenCode adapter → Harness capabilities: uses capabilities
tools/adapters/opencode.py - Copilot adapter → Harness capabilities: uses capabilities
tools/adapters/copilot.py - Antigravity adapter → Harness capabilities: uses capabilities
tools/adapters/antigravity.py - Pi adapter → Harness capabilities: uses capabilities
tools/adapters/pi.py - Codex adapter → Coding harnesses: emits artifacts
README.md - Cursor adapter → Coding harnesses: emits artifacts
README.md - OpenCode adapter → Coding harnesses: emits artifacts
README.md - Copilot adapter → Coding harnesses: emits artifacts
README.md - Antigravity adapter → Coding harnesses: emits artifacts
README.md - Pi adapter → Coding harnesses: emits artifacts
README.md - Plugin maintainer → Evaluation CLI: invokes scoring
README.md - Evaluation CLI → Evaluation engine: runs evaluation
plugins/plugin-eval/src/plugin_eval/cli.py - Evaluation CLI → Evaluation corpus: loads corpus
plugins/plugin-eval/src/plugin_eval/cli.py - Evaluation CLI → Result reporter: formats results
plugins/plugin-eval/src/plugin_eval/cli.py - Evaluation engine → Skill parser: parses skills
plugins/plugin-eval/src/plugin_eval/engine.py - Evaluation engine → Static analysis: runs analysis
plugins/plugin-eval/src/plugin_eval/engine.py - Evaluation engine → LLM judge: runs assessment
plugins/plugin-eval/src/plugin_eval/engine.py - Evaluation engine → Monte Carlo: runs simulations
plugins/plugin-eval/src/plugin_eval/engine.py - Evaluation engine → Evaluation models: builds results
plugins/plugin-eval/src/plugin_eval/engine.py - Evaluation corpus → Skill parser: parses entries
plugins/plugin-eval/src/plugin_eval/corpus.py - Result reporter → Evaluation models: formats models
plugins/plugin-eval/src/plugin_eval/reporter.py - Static analysis → Harness portability: scores portability
plugins/plugin-eval/src/plugin_eval/layers/static.py - LLM judge → LLM SDK helper: queries SDK
plugins/plugin-eval/src/plugin_eval/layers/judge.py - Monte Carlo → LLM SDK helper: queries SDK
plugins/plugin-eval/src/plugin_eval/layers/monte_carlo.py - Monte Carlo → LLM judge: runs simulations
plugins/plugin-eval/src/plugin_eval/layers/monte_carlo.py - Monte Carlo → Evaluation statistics: computes statistics
plugins/plugin-eval/src/plugin_eval/layers/monte_carlo.py