agentleFS
razorpayrazorpay/blade/.agents/skills/heal-pr/SKILL.md

heal-pr

Skill658 starsChanged 4 months agoMITView on GitHub

Heal a Blade PR by fixing CI failures, missing changesets, and sanity issues. Use when a PR has failing CI or other sanity problems that need to be auto-fixed.

  • Commits and pushes

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Missing changeset: create the .changeset file with appropriate bump type — only if the PR contains actual source code changes.

    line 33
  2. Distinctive:

    Any other issue: follow the critique's suggestion

    line 34
  3. Distinctive:

    If any issue cannot be fixed (infra outage, external service downtime, flaky environment), post a comment:

    line 40

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Heal Blade PR

Arguments

  • PR: Link / Number of the PR to heal

Steps

1. Diagnose

Spawn the pr-sanity-critique subagent to identify all issues:

subagent_type: pr-sanity-critique
prompt: "PR_NUMBER={PR_NUMBER}"

2. Fix

Checkout the PR branch and fix each reported issue:

gh pr checkout {PR_NUMBER} --repo razorpay/blade
  • Failing CI: investigate with gh run view --job {JOB_ID} --repo razorpay/blade, then fix the root cause (code, tests, config)
  • Missing changeset: create the .changeset file with appropriate bump type — only if the PR contains actual source code changes. Skip changeset creation for PRs with purely test file changes (e.g. *.test.ts, *.spec.tsx) or documentation-only changes (e.g. *.md, docs/).
  • Any other issue: follow the critique's suggestion

For test or lint failures, verify the fix locally by re-running the failing check before committing.

3. Handle Non-Fixable Issues

If any issue cannot be fixed (infra outage, external service downtime, flaky environment), post a comment:

gh pr comment {PR_NUMBER} --repo razorpay/blade --body ":sparkles: Agentic PR Healer :sparkles:

**Could not auto-fix the following issues:**

{DESCRIPTION}

These require manual intervention."

4. Push

git add -A && git diff --cached --quiet || (git commit -m "fix: auto-heal PR via Slash PR Healer" && git push)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.