Index of every page on this site: llms.txt
All skills
cursor avatar

/check-agent-compatibility

@0b46ec3
by cursorcursor/plugins18k stars
1,933
Run it yourself

Run the full repository compatibility pass: scanner score, startup path, validation loop, and docs reliability.

  • 1 file
  • 2.3 KB
  • Updated 8 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/cursor/plugins/check-agent-compatibility

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈35 tokens for metadata: the name and description. ≈559 when used: this file.

Description uses 1.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈139 characters, or 1.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Check agent compatibility

Trigger

Use when the user wants the full compatibility pass for a repo.

Workflow

  1. Launch compatibility-scan-review to run the CLI and capture the raw repository score and main issues.
  2. Launch startup-review to verify whether the repo can actually be booted by an agent.
  3. Launch validation-review to check whether an agent can verify a small change without an unnecessarily heavy loop.
  4. Launch docs-reliability-review to see whether the documented setup and run paths reliably match reality.
  5. Use one subagent per task. Do not collapse these checks into one agent prompt.
  6. Compute an internal workflow score as the rounded average of:
    • Startup Compatibility Score
    • Validation Loop Score
    • Docs Reliability Score
  7. Compute an Agent Compatibility Score as:
    • round((deterministic_score * 0.7) + (workflow_score * 0.3))
  8. Synthesize the results into one final response.

When scoring internally, use specific non-round workflow scores for the behavioral checks rather than coarse round buckets. If startup, validation, or docs mostly work, treat them as good-with-friction rather than defaulting to the mid-60s. Do not create a low workflow score just because logs are noisy or the error text is rough.

Output

Respond in markdown, but keep it minimal. Do not use fenced code blocks.

Show only one score, as a level-two heading: ## Agent Compatibility Score: N/100. Do not show how it was computed, including weights, formula, deterministic score, workflow score, per-check scores, or arithmetic, unless the user explicitly asks for a breakdown.

Then a flat, prioritized list labeled Top fixes with one issue per line, each line starting with - .

If the deterministic scanner cannot be run because of tool environment issues, say that separately and do not treat it as a repo defect or penalize the repo. Fold deterministic and behavioral findings into that one list instead of separate sections. Focus on the fixes that would most improve real agent workflows. Do not include a separate summary unless the user asks for more detail.

Example shape:

Agent Compatibility Score: 72/100

Top fixes

  • First issue
  • Second issue
  • Third issue

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 0b46ec3. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 8 months ago

README badge

README badge for cursor/plugins/check-agent-compatibility