mcpField
W
writing-issues-and-prs

writing-issues-and-prs

github.com/zlliangDevelopment0245 installsUpdated 2d ago
Repository

About writing-issues-and-prs

Writing Issues and PRs is a platform-neutral skill for writing clear, concise issues, pull requests, work items, and review comments. It provides adaptable outlines and guidance on tone, accuracy, structure, and formatting.

Key features

  1. 01Adapt outlines to the writing context
  2. 02Keep prose concise and direct
  3. 03Support claims with concrete evidence
  4. 04Apply consistent titles and formatting

Use cases

  1. 01Draft a bug report or feature request
  2. 02Write a pull request description
  3. 03Prepare a work item or review comment

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zlliang/skills --skill writing-issues-and-prs

After installing, type/writing-issues-and-prsin Claude Code to confirm it loaded.

Bundled filesreferences/outlines.md

Details

From the project README

Writing Issues and PRs

Whatever the platform, the writing carries the weight. Stay platform-neutral unless the user or surrounding context calls for platform-specific terms.

For starting structures by scenario (bug report, feature request, PR/MR, work item, review comment), read references/outlines.md. Those outlines are examples, not fixed templates: treat them as a starting point and shape the writing to the actual situation — reorder, drop, add, merge, or invent sections as the case demands. Prefer a repo's or tracker's own template whenever one exists.

Writing principles

  • Be concise: omit needless words, cut redundancy and hedging, and prefer plain, direct prose. Make every word count. If it does not fit on one screen, it is too long.
  • Be accurate, well-structured, and insightful, in a calm, natural, and human tone. Be skeptical and precise — double-check reasoning, sources, and assumptions.
  • State the issue, request, or purpose clearly. Explain why it matters. Include concrete evidence.
  • For English prose, follow these style guides, and apply their language-agnostic rules to prose in any language: The Elements of Style, The Sense of Style, and Chicago Manual of Style.

Formatting rules

  • Insert spaces between English words and CJK characters.
  • Use - (hyphen plus space) for unordered list items; never use * or + .
  • Use _italics_ for italics and **bold** for bold.
  • For list items, omit the trailing period when all items are fragments; if any item is a complete sentence, end every item with a period.
  • Never use horizontal dividers (<hr> or ---).
Titles
  • Issue and work item titles use "Sentence case" (capitalize the first word only).
  • Pull request and merge request titles use Conventional Commits format, following the git-commit skill: <type>[optional scope]: <description>.
Body headings
  • Do not force the text to begin with a heading. Use headings only when they add structural clarity; a short opening sentence or paragraph can come first.
  • Use heading levels sequentially (h2, then h3, etc.); never skip levels.
  • Never use h1, and never number headings (e.g., ## About me, not ## 1. About me).

Comments

Markdown supported