Skip to content

chore(governance): add shared agent skills for creating issues and PRs - #5407

Merged
dreamorosi merged 2 commits into
mainfrom
chore/add-project-agent-skills
Jul 8, 2026
Merged

dreamorosi merged 2 commits into
mainfrom
chore/add-project-agent-skills

Conversation

@svozza

@svozza svozza commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds project-specific agent skills that encode this repository's conventions for creating GitHub issues and pull requests, so AI coding agents follow the project's templates instead of producing free-form output. Skills live once in .agents/skills/ (an emerging cross-harness convention), avoiding duplicate copies per harness directory.

Changes

  • Add .agents/skills/create-issue/SKILL.md — instructs agents to read the templates in .github/ISSUE_TEMPLATE/, draft the issue, and get user approval before posting
  • Add .agents/skills/create-pr/SKILL.md — instructs agents to follow the PR template, conventional-commit titles, and draft-first workflow
  • Add committed symlinks .claude/skills/create-issue and .claude/skills/create-pr pointing into .agents/skills/, since Claude Code does not yet read .agents/skills/ natively (removable once it does)
  • Add AGENTS.md pointing agents without native skill discovery at .agents/skills/
  • Update .gitignore with negation rules so the symlinks and AGENTS.md are tracked while the rest of .claude/ stays ignored

Issue number: closes #5406


By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

Skills live once in .agents/skills/ with committed symlinks in
.claude/skills/ for Claude Code support, plus an AGENTS.md pointer
for other coding agents.

Related to #5406
@powertools-for-aws-oss-automation powertools-for-aws-oss-automation Bot added size/L PRs between 100-499 LOC and removed size/L PRs between 100-499 LOC labels Jul 8, 2026
@dreamorosi
dreamorosi merged commit ee14bbc into main Jul 8, 2026
41 checks passed
@dreamorosi
dreamorosi deleted the chore/add-project-agent-skills branch July 8, 2026 14:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/L PRs between 100-499 LOC

2 participants