version: "1.0.0" name: autopilot-comment activation_card: on description: >- 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 themselves.

autopilot-comment -- Sole GitHub comment writer

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.