Using GitHub
Use this skill as the single entry point for GitHub work. It owns issue
creation, issue editing, issue branch creation, milestone changelog rendering,
and pull request preparation.
First Checks
- Read root repository guidance such as
AGENTS.md.
- Read
docs/issue-filing-style.md when filing or editing issues — it is the
single source of truth for issue-filing conventions in this repo.
- Read local docs that govern the files or GitHub surface being changed.
- Use repository templates for issues and pull requests.
- Use canonical labels from the remote label inventory.
- Do not manually apply or remove reserved release automation labels.
- Keep public-repo output free of private repository URLs, private paths, and
private content.
- Stay in the current working directory's default
gh repository unless the
repository guidance explicitly allows cross-repo work.
Required Procedures
Follow the matching procedure before taking GitHub actions. These files are
supporting workflow contracts for this skill, not separate installable skills.
- New issue: follow
workflows/new-issue.md.
- Existing issue edit: follow
workflows/edit-issue.md.
- Start issue work: follow
workflows/new-branch.md.
- Milestone changelog: follow
workflows/write-changelog.md.
- Pull request: follow
workflows/pull-request.md.
Shared GitHub Rules
- Branches for issue work use
<issue-number>-<kebab-title> from the default
branch.
- Commits and squash PR titles use
type: #123 short description with no
scope, unless the change is breaking. Breaking changes use type!: #123 short description.
- GitHub issue titles are plain-language summaries, not conventional commits.
- Relationships are same-repo
#N references unless repository guidance says
otherwise.
- Public issue, PR, and changelog text must pass the public-repo leak guard.
- Duplicate checks happen before filing new issues.
- Label choices come from
gh label list; do not invent labels.
- Pull request bodies use the repository template headings in order.
- Long issue, PR, and discussion descriptions keep top-level sections at
##
so GitHub's auto-TOC sidebar surfaces them — see
docs/issue-filing-style.md section "Heading levels for navigability".
Public-Repo Leak Guard
Before creating or updating public issues, PRs, changelog text, or rendered
release notes:
- Resolve the target repository and visibility with
gh repo view.
- If the target is public, scan the draft for private GitHub URLs and private
path-shaped content.
- Refuse confirmed leaks.
- Surface ambiguous content for explicit review instead of silently rewriting.
Common Mistakes
| Mistake |
Fix |
| Looking for a separate sub-skill per workflow |
None exist — this skill and its workflows/ files are the entry point. |
| Inventing labels or templates |
Read the repository label inventory and templates. |
Treating PR creation as just a gh pr create command |
Satisfy the repository PR template, title format, and acceptance-criteria rules first. |
| Including private repository context in public text |
Rewrite as a public-safe summary or file in a private repository first. |
1---2name: using-github3description: Use when working with GitHub in this repository — creating or editing issues, starting an issue branch, preparing a pull request, or rendering a milestone changelog. Triggers include "file an issue", "create issue", "edit issue #N", "start work on #N", "open a PR", "prepare pull request", and "generate changelog for milestone X".4metadata:5 source: https://skillmd.com/skills/patinaproject/using-github6---78# Using GitHub910Use this skill as the single entry point for GitHub work. It owns issue11creation, issue editing, issue branch creation, milestone changelog rendering,12and pull request preparation.1314## First Checks1516- Read root repository guidance such as `AGENTS.md`.17- Read `docs/issue-filing-style.md` when filing or editing issues — it is the18 single source of truth for issue-filing conventions in this repo.19- Read local docs that govern the files or GitHub surface being changed.20- Use repository templates for issues and pull requests.21- Use canonical labels from the remote label inventory.22- Do not manually apply or remove reserved release automation labels.23- Keep public-repo output free of private repository URLs, private paths, and24 private content.25- Stay in the current working directory's default `gh` repository unless the26 repository guidance explicitly allows cross-repo work.2728## Required Procedures2930Follow the matching procedure before taking GitHub actions. These files are31supporting workflow contracts for this skill, not separate installable skills.3233- New issue: follow `workflows/new-issue.md`.34- Existing issue edit: follow `workflows/edit-issue.md`.35- Start issue work: follow `workflows/new-branch.md`.36- Milestone changelog: follow `workflows/write-changelog.md`.37- Pull request: follow `workflows/pull-request.md`.3839## Shared GitHub Rules4041- Branches for issue work use `<issue-number>-<kebab-title>` from the default42 branch.43- Commits and squash PR titles use `type: #123 short description` with no44 scope, unless the change is breaking. Breaking changes use `type!: #123 short45 description`.46- GitHub issue titles are plain-language summaries, not conventional commits.47- Relationships are same-repo `#N` references unless repository guidance says48 otherwise.49- Public issue, PR, and changelog text must pass the public-repo leak guard.50- Duplicate checks happen before filing new issues.51- Label choices come from `gh label list`; do not invent labels.52- Pull request bodies use the repository template headings in order.53- Long issue, PR, and discussion descriptions keep top-level sections at `##`54 so GitHub's auto-TOC sidebar surfaces them — see55 `docs/issue-filing-style.md` section "Heading levels for navigability".5657## Public-Repo Leak Guard5859Before creating or updating public issues, PRs, changelog text, or rendered60release notes:61621. Resolve the target repository and visibility with `gh repo view`.632. If the target is public, scan the draft for private GitHub URLs and private64 path-shaped content.653. Refuse confirmed leaks.664. Surface ambiguous content for explicit review instead of silently rewriting.6768## Common Mistakes6970| Mistake | Fix |71|---------|-----|72| Looking for a separate sub-skill per workflow | None exist — this skill and its `workflows/` files are the entry point. |73| Inventing labels or templates | Read the repository label inventory and templates. |74| Treating PR creation as just a `gh pr create` command | Satisfy the repository PR template, title format, and acceptance-criteria rules first. |75| Including private repository context in public text | Rewrite as a public-safe summary or file in a private repository first. |