Drop 'Cursor' from plugin descriptions in the marketplace manifest and per-plugin manifests so they read correctly in any agent client, and resync the README table that mirrors them. Co-authored-by: Alex Vandak Maloney <maloney.a12@gmail.com>
Agent Compatibility
Cursor plugin for checking how well a repo holds up under agent workflows. It pairs the published agent-compatibility CLI with focused reviews for startup, validation, and docs reliability.
By default, the full pass returns one overall score and one short list of the highest-leverage fixes. If the user wants the full breakdown, the agents can expose the component scores and the reasoning behind them.
What it includes
check-agent-compatibility: full compatibility passcompatibility-scan-review: raw CLI-backed scanstartup-review: cold-start and bootstrap reviewvalidation-review: small-change verification reviewdocs-reliability-review: docs reliability review
Score model
Agent Compatibility Score: final blended score shown to the userDeterministic Compatibility Score: raw score from the published CLIStartup Compatibility Score: how much guesswork it takes to boot the repoValidation Loop Score: how practical it is to verify a small changeDocs Reliability Score: how closely the docs match the real setup path
The final score blends the deterministic scan with the workflow checks:
Agent Compatibility Score = round((deterministic * 0.7) + (workflow * 0.3))
The CLI also reports an accelerator layer for committed agent tooling. That extra context informs recommendations, but it does not inflate the deterministic compatibility score itself.
How to use it
Use check-agent-compatibility when you want the full pass. That skill fans out to the four review agents above, then returns a compact result:
## Agent Compatibility Score: 72/100
Top fixes
- First issue
- Second issue
Ask for a breakdown if you want the component scores or the weighting.
CLI notes
The plugin does not bundle the scanner. It runs the published npm package when needed.
Default scan (compact terminal dashboard):
npx -y agent-compatibility@latest .
JSON output:
npx -y agent-compatibility@latest --json .
Markdown output:
npx -y agent-compatibility@latest --md .
Plain text output:
npx -y agent-compatibility@latest --text .
Config override for ignored paths or weight overrides:
npx -y agent-compatibility@latest . --config ./agent-compatibility.config.json
The scanner is heuristic. It scores repo signals and surfaces likely friction, but it is not a full quality verdict on the codebase.
Local install
If you want to use this plugin directly, symlink this directory into:
~/.cursor/plugins/local/agent-compatibility