jira-refine-issue

Rewrite a Jira issue's title and description to match Anurag's writing conventions.

1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/andeart/dotfiles --skill jira-refine-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-refine-issue
Source: https://github.com/andeart/dotfiles/tree/main/agents/skills/jira-refine-issue
Command: npx skills add https://github.com/andeart/dotfiles --skill jira-refine-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refine an existing Jira issue's title and description to align with Anurag's writing conventions, improving clarity, structure, and consistency across Jira issues.

Core Features & Use Cases

  • Title and Description Refinement: Update an issue's wording to be clear, outcome-focused, and in sentence case as per conventions.
  • Scope Limitations: Keeps assignee, priority, status, links, comments, and history unchanged; only rewrites title and description.
  • Use Case: When a Jira issue like ENG-123 or a Jira URL needs tidying to remove ambiguity and align with established templates.

Quick Start

Paste the Jira issue key or URL and request a rewritten title and description that follow Anurag's conventions.

Frequently Asked Questions about jira-refine-issue

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

FAQPage Schema
How do I rewrite a Jira issue title and description to improve clarity and structure?

To refine a Jira issue, you provide the issue key or URL to apply convention-based wording, sentence case formatting, and structural improvements to the title and description while preserving assignee, priority, and status.

Does refining a Jira issue modify the assignee, priority, or status?

No, refining a Jira issue does not modify the assignee, priority, status, links, comments, or history. The process strictly limits changes to rewriting only the issue title and description for clarity.

What is the best way to align existing Jira issues with established writing conventions?

The best way to align Jira issues with writing conventions is to retrieve the issue, apply template guidelines for outcome-focused wording and sentence case, and require user confirmation before applying the updated title and description.

Can I use a Jira URL to automatically rewrite an issue's wording?

Yes, you can use a Jira URL to automatically retrieve an issue and propose a rewritten title and description. The tool retrieves the issue data and generates a refined version pending your manual confirmation.

When should I not use an automated Jira issue refinement process?

You should not use automated Jira issue refinement when you need to update fields beyond the title and description, such as assignee, priority, status, or comments, as the process is strictly limited to wording and structure changes.