Is this skill suitable for AI agents?

Absolutely. The structured output is specifically designed to provide the level of detail and context that AI coding agents like Claude Code need to execute tasks accurately.

How does refine-issue gather technical context?

The skill searches your local codebase and linked repositories to find relevant files, functions, and specific lines of code related to the issue description.

Can I customize the issue templates?

Yes, the skill follows specific markdown structures for bugs, features, and refactors to ensure consistency across your team's project management workflow.

Does it update my issues automatically?

No, the skill generates a structured draft for your review and only updates the issue tracker once you have provided explicit approval of the content.

Which issue trackers are supported?

It currently supports native integration with Linear and GitHub via MCP (Model Context Protocol) tools for fetching and updating issues.

Refine Issue

Name: Refine Issue
Author: bendrucker

bybendrucker

•

Collaboration Tools

Transforms brief bug reports and feature requests into detailed, actionable technical specifications for developers and AI agents.

About

The refine-issue skill streamlines the transition from raw ideas to implementation-ready tasks by enriching brief descriptions with deep technical context. It automatically classifies requests into Bugs, Features, or Refactors and crawls the codebase to provide specific file references and line-number permalinks. By standardizing the output structure and integrating directly with GitHub or Linear, it ensures that both human developers and AI coding assistants have the precise information needed to start work immediately, significantly reducing project management overhead.

Key Features

Deep code context gathering with permalinks and line-specific references
Bidirectional integration with GitHub and Linear issue trackers
5 GitHub stars
Standardized output structure including summary, context, and related issues
Review-first workflow requiring user approval before updating trackers
Automated classification of Bug, Feature, and Refactor requests

Use Cases

Preparing feature specifications for AI coding agents to implement
Documenting refactor proposals with explicit code references and dependencies
Converting a one-sentence bug report into a detailed technical issue

About

Key Features

Deep code context gathering with permalinks and line-specific references
Bidirectional integration with GitHub and Linear issue trackers
5 GitHub stars
Standardized output structure including summary, context, and related issues
Review-first workflow requiring user approval before updating trackers
Automated classification of Bug, Feature, and Refactor requests

Use Cases

Preparing feature specifications for AI coding agents to implement
Documenting refactor proposals with explicit code references and dependencies
Converting a one-sentence bug report into a detailed technical issue