Skill

issue:refine

Refines brief bug, feature, or refactor descriptions into structured issues with technical context, code links, and details for developers and AI agents.

Github

git-workflow

Install

npx claudepluginhub bendrucker/claude --plugin issue

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Expand brief issue descriptions into structured issues for developers and AI agents.

Supporting Assets

bug.mdfeature.mdrefactor.md

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Parent Repo Stars10

Parent Repo Forks1

Last CommitMar 30, 2026

Actions

View Source View Plugin View on GitHub View README

Issue Refinement

Expand brief issue descriptions into structured issues for developers and AI agents.

Issue Types

Type	When to Use	Guide
Bug	Something is broken	`bug.md`
Feature	New capability	`feature.md`
Refactor	Internal improvement, no behavior change	`refactor.md`

Workflow

Identify type and read the corresponding guide
Gather context from code and related issues
Draft refinement following the type-specific structure
Output for user approval before updating the issue

Output Structure

All issues share this skeleton. Type guides add sections in between.

## Summary

One to two sentences.

[Type-specific sections from guide]

## Context

### Related Code

Files that need changes or inform the work.

### Related Issues

Links to related issues, prior attempts, upstream work.

Style

Direct - Facts, not hedging
Specific - Name the function, file, behavior
Concise - Every sentence adds information
Link to code - Permalinks for GitHub (https://github.com/{owner}/{repo}/blob/{sha}/path#L10-L20), file paths elsewhere (path/to/file:10-20)

Issue Trackers

Fetch with get_issue, output refinement for review, update only after approval.

Linear: mcp__linear__get_issue, mcp__linear__update_issue, or mcp__claude_ai_Linear__get_issue, mcp__claude_ai_Linear__save_issue
GitHub: mcp__github__get_issue, mcp__github__update_issue