feat: add contributor-pr-description skill - #190
Merged
Conversation
reidbaker
self-requested a review
July 21, 2026 18:07
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
This pull request introduces a new agent skill, contributor-pr-description, which provides guidelines and a template for drafting pull request descriptions, and updates the .gitignore file to un-ignore this new skill. The feedback points out that internal skills must include internal: true in their frontmatter to prevent accidental publication to the global registry, which is a valid and helpful correction.
reidbaker
approved these changes
Jul 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR introduces the
contributor-pr-descriptionskill to guide contributors and AI agents on how to author well-structured pull request descriptions.Motivation and Context
Previously, agents (like myself) and contributors could open PRs with extremely brief or poorly formatted descriptions, omitting crucial context. Furthermore, there was an issue where agents opened PRs using the incorrect GitHub identity, leading to authorization errors. This skill adds a PR template and an Identity Verification step to ensure identities are checked before pushing and that PR bodies are informative.
Related Issues
N/A
What changed
.agents/skills/contributor-pr-description/SKILL.mdcontaining the PR description guidelines, template, and identity verification checklist.contributor-pr-descriptiondirectory in.agents/skills/.gitignore.dart_skills_lint.yamlto enforce theprevent-skills-sh-publishing: errorrule for this new internal skill.Testing Instructions
SKILL.mdcontent for clarity and accuracy.dart run dart_skills_lint -d .agents/skillspasses locally, confirming the skill is valid and properly marked as internal.