autopilot-comment -- Sole GitHub comment writer

SkillDev tools

Lets your agent post or patch one GitHub comment on a microsoft/apm autopilot run, with a built-in AI disclaimer footer.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the autopilot-comment -- Sole GitHub comment writer skill

About this capability

Use this skill to post or patch ONE GitHub comment for a microsoft/apm autopilot run. It owns public vs debug body assembly and the AI disclaimer footer. Never labels, assigns, requests reviewers, or merges. Autopilot skills that write comments must load this skill and must not call gh comment APIs

What this skill tells your AI

The instructions your AI receives, as published by microsoft/apm in .agents/skills/autopilot-comment/SKILL.md and read by ahel’s review.

Any autopilot skill that would write a GitHub comment loads this skill in the same session and stops if the card is missing. Do not spawn a nested session. Do not comment from the caller.

Activation card

activation_card: on. Before any GitHub comment write, emit this Enter card with every field filled. Missing field -> stop.

skill: autopilot-comment
skill_path: <resolved directory of this SKILL.md>
mode: run
subject: microsoft/apm#<number>
path: comment
intent: post one GitHub comment | patch one GitHub comment
origin: unattended | actor-session
write: on | off
debug: off | on
repo: microsoft/apm
target_kind: issue | pull
target: <positive integer>
source_skill: <canonical autopilot skill name>
comment_id: none | <positive integer>
invocation: agentic-workflow | actor-session
receipt: <HTML comment watermark line>
public_body: <author-facing prose, no JSON, no footer>
debug_body: <full internal template without JSON fence, or none>

Rules:

  • write defaults to on when the caller omitted it.
  • write: off returns the assembled body only. Do not post or patch.
  • write: on posts or patches exactly one comment. Never labels, assigns, requests reviewers, or merges.
  • debug defaults to off when omitted or unknown. Omitted debug is not a missing-field stop.
  • debug: off -> HTML receipt plus public_body. Do not post internal headings from debug_body.
  • debug: on -> first line [i] Skill debug is on. then receipt plus debug_body (or public_body if debug_body is none).
  • comment_id: none with intent post. A numeric comment_id with intent patch. Mismatch -> stop.
  • source_skill is the caller (for example autopilot-issue-triage-worker). Never autopilot-comment.
  • origin fail-closed unknown -> unattended.
  • Strip any JSON fence from bodies before assembly. Never post JSON on GitHub.

After the write (or dry-run), emit this Exit receipt:

skill: autopilot-comment
subject: microsoft/apm#<number>
path: comment
write: on | off
debug: off | on
posted: yes | no
patched: yes | no
comment_id: <id or none>
source_skill: <canonical autopilot skill name>
approved: n/a

Assemble

  1. Drop JSON fences and triage-recommendation blocks.
  2. Build the body from debug as above. ASCII only.
  3. Append this exact footer, substituting source_skill:
---

Generated by <source_skill>. This comment is AI-generated and may contain errors.
  1. If the footer is already the last lines, do not duplicate it.

Write

Actor-session / Copilot App / Cloud / Remote:

  • issue + post: gh issue comment <target> --body-file ...
  • pull + post: gh pr comment <target> --body-file ...
  • patch: gh api -X PATCH /repos/microsoft/apm/issues/comments/<comment_id>

Agentic Workflow: safe-outputs.add-comment for post. Patch is not available; stop if intent is patch.

One comment per activation. No progress comments.

Hard nos

  • Do not assign, request reviewers, merge, or edit labels.
  • Do not implement.
  • Do not compose schedulers or other workers.
  • ASCII only.

Signals

GitHub stars
4k
Forks
369
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
autopilot-comment
Source
github.com/microsoft/apm
autopilot-comment -- Sole GitHub comment writer · ahel