Check agent files in pull requests

What it checks

Only the agent files the pull request changes. A pull request that touches none of them is skipped and costs nothing.

• CLAUDE.md and AGENTS.md, at the root or in any folder
• .cursorrules and files under .cursor/rules
• .github/copilot-instructions.md
• GEMINI.md

A later push is checked again only when it changes an agent file. The one comment is updated, so a pull request carries one comment, not a new one per commit.

Free and Pro

Set it up

1. Create a key in settings, under GitHub checks.
2. Add it to your repository as an Actions secret named FMP_KEY.
3. Add this workflow as .github/workflows/agent-check.yml:

name: Agent file check
on:
  pull_request:
    paths:
      - "**/CLAUDE.md"
      - "**/AGENTS.md"
      - ".cursorrules"
      - ".cursor/rules/**"
      - ".github/copilot-instructions.md"
      - "GEMINI.md"

permissions:
  contents: read
  pull-requests: write

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: fixmyprompt/agent-check@v1
        with:
          fmp-key: ${{ secrets.FMP_KEY }}

To fail the check on a low score, add fail-below: 70 under with. If FixMyPrompt cannot be reached, or your free checks are used up, the check passes.