Agent skill

PR Description

by gduteil in gduteil/cozytouch

Write or rewrite a pull request description so it is short and actually readable.

No licenceAuto-check passedDevelopment

Install PR Description

skills CLI
$ npx skills add gduteil/cozytouch --skill pr-description -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gduteil/cozytouch pr-description --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gduteil/cozytouch.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/pr-description .claude/skills/pr-description && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pr-description
GitHub stars
128
Token cost
~539 tokens
SKILL.md length
286 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Write or rewrite a pull request description so it is short and actually readable.

  • Works in 3 steps: Any sentence that starts "This PR". → Any sentence explaining what a reviewer… → Any hedge that carries no uncertainty.
  • Editing a PR body
  • SKILL.md covers Shape, Title, Hard limits and Where the words come from, plus 2 more sections
  • Calls pytest and ruff

What it does

PR Description is an agent skill from gduteil/cozytouch. Write or rewrite a pull request description so it is short and actually readable. Use when opening a PR, editing a PR body, or when the user says "PR description", "describe this PR", "gh pr create", or complains a PR body is too long.

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Pull requests. It works with Home Assistant. The repository describes itself as: Atlantic Cozytouch integration for Home Assistant.

When your agent uses it

  • Editing a PR body
  • The user says PR description
  • Describe this PR
  • Complains a PR body is too long

Example prompts

  • “PR description”
  • “describe this PR”
  • “gh pr create”
  • “/pr-description”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Any sentence that starts "This PR".
  2. Any sentence explaining what a reviewer could read in the diff.
  3. Any hedge that carries no uncertainty.

What it can do on your machine

Read from SKILL.md and the folder at commit bdfbd56. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pytest
    • ruff

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PR Description loads about 539 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 286 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~539

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 286 words (~539 tokens).

“A PR body is read once, in a hurry, on a phone. The diff is already on the page. The body exists to say why, not to narrate what the reader can see.”

— opening of SKILL.md by gduteil
name
pr-description

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/pr-description of gduteil/cozytouch.

Open the folder on GitHubat commit bdfbd56

Compare with similar skills

PR Description next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PR Description compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR Description this skillgduteil/cozytouch128—~539Automated safety check: PassNone
Community Triageroryeckel/wyoming_openai218—~2.9kAutomated safety check: PassApache-2.0
simon42 Dashboard Strategy Dev GuideTheRealSimon42/simon42-dashboard-strategy262—~3.6kAutomated safety check: PassCustom licence
PR Bodyandrew-blake/melcloudhome142—~3.3kAutomated safety check: PassMIT
PRjtenniswood/espcontrol1.1k—~1.4kAutomated safety check: PassCustom licence
Huawei PRxiasi0/ha-huawei-smarthome124—~501Automated safety check: PassGPL-3.0

Similar skills

  • Community Triage

    roryeckel/wyoming_openai

    GitHub issues, pull requests, bug reports, scope questions, and support threads.

    218 GitHub stars~2.9k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • simon42 Dashboard Strategy Dev Guide

    TheRealSimon42/simon42-dashboard-strategy

    Working rules for developing the simon42 Home Assistant dashboard strategy: verify before assuming, protect existing behavior, test on a real system and handle community PRs with care.

    262 GitHub stars~3.6k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • PR Body

    andrew-blake/melcloudhome

    A skill your agent uses when composing or revising a pull request description in this repo, including PRs that sit in a stack.

    142 GitHub stars~3.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • PR

    jtenniswood/espcontrol

    Review a new or open pull request for this repository with an adversarial security and quality lens.

    1.1k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Huawei PR

    xiasi0/ha-huawei-smarthome

    Standardize pull request titles and descriptions for the ha-huawei-smarthome repository.

    124 GitHub stars~501 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Ha Android Committing

    home-assistant/android

    Home Assistant Android change finalization. An agent skill from home-assistant/android.

    4k GitHub stars~658 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from gduteil/cozytouch

  • Release Notes

    gduteil/cozytouch

    Write releasenotes/<version.md for a Cozytouch release — what the release means for somebody running it, in their words, with a section emoji per theme.

    128 GitHub stars~876 tokensUpdated yesterday
    Auto-check passed
  • Verify Cozytouch

    gduteil/cozytouch

    Prove a change to the Cozytouch Home Assistant integration in a real Home Assistant — a throwaway instance against a fake Atlantic cloud served from a diagnostics dump (a fixture or a reporter's)…

    128 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Catalogue Issue

    gduteil/cozytouch

    Turn an issue the maintainer's catalogue routine opened — "Atlantic changed the capability / model / product catalogue" — into a pull request.

    128 GitHub stars~902 tokensUpdated yesterday
    Auto-check passed
  • Steward

    gduteil/cozytouch

    How to drive a pull request on this repository to mergeable — CI fixes, review comments, snapshots, what to ask the maintainer.

    128 GitHub stars~606 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about PR Description

What does PR Description do?

Write or rewrite a pull request description so it is short and actually readable. PR Description is an agent skill from gduteil/cozytouch. Write or rewrite a pull request description so it is short and actually readable.

When should I use PR Description?

PR Description fits situations like: editing a PR body; the user says PR description; describe this PR; complains a PR body is too long.

How do I install PR Description in Claude Code?

Run `npx skills add gduteil/cozytouch --skill pr-description -a claude-code`. Or copy the skill folder (.claude/skills/pr-description in gduteil/cozytouch) into .claude/skills/pr-description in your project. Claude Code loads it when a task matches its description.

How do I install PR Description in Codex?

Run `npx skills add gduteil/cozytouch --skill pr-description -a codex`. Or copy the skill folder (.claude/skills/pr-description in gduteil/cozytouch) into .agents/skills/pr-description in your project. Codex loads it when a task matches its description.

Can I use PR Description in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gduteil/cozytouch --skill pr-description -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr-description, .gemini/skills/pr-description, .github/skills/pr-description and .opencode/skills/pr-description in your project.

What does PR Description need to run?

Going by SKILL.md and its folder, PR Description needs the command-line tools its instructions call (pytest and ruff).

Does PR Description access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is PR Description safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does PR Description use?

No licence was found for PR Description or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does PR Description use?

About 539 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PR Description?

Skills that share tags, products or a category with PR Description: Community Triage (roryeckel/wyoming_openai, 218 stars), simon42 Dashboard Strategy Dev Guide (TheRealSimon42/simon42-dashboard-strategy, 262 stars), PR Body (andrew-blake/melcloudhome, 142 stars) and PR (jtenniswood/espcontrol, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR Description?

gduteil (a GitHub user) maintains it in gduteil/cozytouch, which has 128 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

Source: gduteil/cozytouch on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.