skills.rest
pnewsam
pnewsamCOMMUNITY
Explore all skills by this author →
Website𝕏@paultakumaGitHub

polish-issue

Rewrites Linear issue titles and descriptions for clarity without changing their meaning.

1|Updated Apr 15, 2026
Search Tags:#readability#mcp#linear#ticket#issue#polish#rewrite
One-click install
npx skills add https://github.com/pnewsam/skills --skill polish-issue-pnewsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polish-issue
Source: https://github.com/pnewsam/skills/tree/main/archive/registry-rebuild/polish-issue
Command: npx skills add https://github.com/pnewsam/skills --skill polish-issue-pnewsam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Linear issues often accumulate vague, repetitive, or overly formal language that makes them hard for teammates to scan and act on. This Skill improves the readability of an existing issue's title and description while strictly preserving its requirements, scope, acceptance meaning, links, and checklist state. ## Core Features & Use Cases - Preview mode: Fetches the live issue and returns a proposed title and description without editing Linear, so you can review the rewrite first. - Apply mode: Updates only the title and description, then re-fetches the issue to verify the exact result. - Substance preservation: Never changes status, assignee, labels, priority, checkbox states, or acceptance criteria; flags any wording change that could alter meaning. - Use Case: A product manager has a backlog of tickets written hastily during triage. They ask the agent to polish each issue so engineers can understand the outcome and constraints at a glance, without any risk of scope drift. ## Quick Start Use $polish-issue to make this Linear issue clearer without changing its meaning.

Frequently Asked Questions about polish-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rewrite a Linear issue without changing its meaning?▼

Use this Skill to polish the issue's title and description while preserving requirements, scope, acceptance meaning, links, and checkbox states. It improves sentence structure, plain language, and scanability, and flags any wording change that could alter meaning instead of applying it.

Can I preview Linear issue edits before applying them?▼

Yes, Preview mode fetches the live issue and returns a proposed title and description without editing Linear. Apply mode only runs when you explicitly ask to polish, rewrite, or apply the language change, and it verifies the live result afterward.

Does polishing a Linear issue change its status, labels, or assignee?▼

No, the Skill never changes status, team, project, assignee, priority, labels, estimate, cycle, due date, parent, relations, comments, or checklist state. It only edits the title and description text.

What happens if a Linear issue description is empty or incomplete?▼

If the description is empty or too incomplete to polish without inventing substance, the Skill stops and explains what factual input is missing. It does not infer requirements, user impact, or acceptance criteria.

Why does the Linear polish workflow require an MCP connection?▼

The Skill reads and writes live issues through the Linear MCP server, so an authenticated connection is required. If it is unavailable, you must complete the Linear connection and OAuth setup and restart before continuing.

Related Skills

Explore More Product & Management Skills→
kinglerkingler

linear-fix-issue

Convert Linear issues into prioritized subtasks with implementation plans.

Community
Advanced
NealschNealsch

Forge-Task-Routing

Classifies engineering work and assigns the responsible agent and required skills.

Community
Intermediate
EdgeAppEdgeApp
1

no-slop

Enforce stylistic guidelines to eliminate AI-generated writing patterns in technical prose.

Official
Intermediate
jrhueiuengjrhueiueng

client-letter

Generate routine client correspondence templates for law clinic workflows.

Community
Intermediate