agentleFS
runxhqrunxhq/runx/skills/github-pr-comment/SKILL.md

github-pr-comment

Skill97 starsChanged 32 days agoApache-2.0View on GitHub

Post one exact GitHub pull-request comment through the GitHub connector, with retry safety and independent readback.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    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
  • could be automatic: a setting could enforce it
  1. Very specific:

    Use it after a review workflow has produced final wording and the operator wants that exact note posted.

    line 13
  2. Distinctive:

    Stop when repository, pull-request number, body, or idempotency key is missing or changes after admission.

    line 35
  3. Distinctive:

    Do not treat mutation acceptance without an independent comment read whose id and body match as final readback.

    line 40
  4. Distinctive:

    Never merge, close, label, or otherwise mutate the pull request beyond the exact comment.

    line 42

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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

GitHub PR Comment

Post one bounded review comment to one known GitHub pull request. The skill is deliberately narrower than a general GitHub operator: it binds the exact repository, pull request, and comment body to a scoped provider operation, and closes only when provider evidence identifies and reads back the created note.

Use it after a review workflow has produced final wording and the operator wants that exact note posted. Use issue-triage for analysis and drafting, and a broader GitHub skill for other resource types. This skill never merges a pull request; comment authority cannot be promoted into merge authority.

How it works

  1. Supply owner/name, the exact pull-request number, exact comment body, and a stable idempotency key for that body.
  2. The default post runner calls github/comments.create once with the exact body, under the GitHub instance selected here: the signed-in gh session or a stored token.
  3. The runtime records GitHub's acknowledgement, reads the comment back by its id, and completes only when the read-back id and body match the approved comment.

The separate merge-refused runner asks for github/pullrequest.merge under the same comment grant. It is an executable authority test: the merge request must seal as policy denied, never as a backdoor merge path.

Stop conditions

  • Stop when repository, pull-request number, body, or idempotency key is missing or changes after admission.
  • Refuse a provider grant that does not resolve uniquely to pr.comment.
  • Refuse when no GitHub instance is selected, or the selected one cannot comment; the skill never handles a raw token.
  • Do not treat mutation acceptance without an independent comment read whose id and body match as final readback.
  • Never merge, close, label, or otherwise mutate the pull request beyond the exact comment.

Example

An operator invokes post with “Please add the missing recovery fixture” for PR 42 under a pr.comment grant. The skill posts exactly that body under the stable retry key and seals the returned comment id. Changing the body changes the operation identity. Attempting to reuse the comment grant for merge is denied before GitHub mutation.

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.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.