alice.mosphere.at / cursor-plugins
Cursor plugin specification and official plugins
Star
Fork 0
Watch
cursor-plugins agent-compatibility
4 folders · 3 files
.cursor-plugin
agents
assets
skills
CHANGELOG.md
LICENSE
README.md
README.md

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 pass
  • compatibility-scan-review: raw CLI-backed scan
  • startup-review: cold-start and bootstrap review
  • validation-review: small-change verification review
  • docs-reliability-review: docs reliability review

Score model #

  • Agent Compatibility Score: final blended score shown to the user
  • Deterministic Compatibility Score: raw score from the published CLI
  • Startup Compatibility Score: how much guesswork it takes to boot the repo
  • Validation Loop Score: how practical it is to verify a small change
  • Docs 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