ai-agent-pr-metadata
Installation
SKILL.md
AI Agent PR Metadata
Use this when a repository needs traceable AI assistance metadata in GitHub while keeping commit history human-authored and attribution-free.
Rules
- Commit attribution follows
system-level/core.md(Git: no AI co-author metadata unless explicitly required). This skill governs where the traceable detail goes instead: PR bodies, PR comments, and PR review bodies only. - Never guess the model name. Read the authoritative resolved model+version from the runtime or orchestrator; a product alias is not evidence of a model ID.
- Include a run URL when the work was produced by GitHub Actions or another traceable runner.
- Public issues, PRs, comments, and review records must never include credential values or local credential-file paths. Use
Credential details: [redacted]instead. - Never paste a full
https://github.com/...URL to a third-party issue/PR into a private tracker/automation repo's own PR body, commit message, or issue text (e.g. test-plan notes citing which PRs a script nudged). GitHub creates a "mentioned this pull request" cross-reference on the target PR's public timeline regardless of the referencing repo's visibility — non-collaborators can't open the private repo, but they do see your username and the referencing PR/commit's title. Reference it as bareowner/repo#123text (nogithub.comdomain) instead; that form doesn't trigger the backlink. If a leak already happened, renaming the private PR to a neutral title retroactively fixes what's displayed, since GitHub renders the title live at read time.
Agent Labels
- Apply an additive
agent:<model+version>-<effort>-<role>label to the claimed issue and its PR only after the runtime or orchestrator has supplied the resolved model+version. - Use that resolved identifier and declared effort exactly. Do not construct a label from an alias such as
gpt5. - Never replace the resolved model version or declared effort with an alias or a stronger/weaker value.
- Create the label before applying it if it does not already exist, and never remove other agents'
agent:*labels. - Example:
gpt5.6-terraatmediumeffort as the implementer requiresagent:gpt5.6-terra-medium-implementer.