agentsclimarketplace

Writing issues and prs

Skill zlliang/skills/skills/writing-issues-and-prs

My agent skills.

Install
npx -y skills add zlliang/skills --skill writing-issues-and-prs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Write, edit, review, or improve concise titles, bodies, and comments for issues, pull requests, and merge requests on GitHub and GitLab, and for work items (tickets, stories, tasks, epics) on Jira, Linear, and similar issue and project trackers.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.5 KB, 524 tokens by cl100k_base, as published. Nobody here has run it

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).

What ships with it: 1 file

2.6 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.