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

•

コラボレーションツール

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

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.

主な機能

01Deep code context gathering with permalinks and line-specific references

02Bidirectional integration with GitHub and Linear issue trackers

035 GitHub stars

04Standardized output structure including summary, context, and related issues

05Review-first workflow requiring user approval before updating trackers

06Automated classification of Bug, Feature, and Refactor requests

ユースケース

01Preparing feature specifications for AI coding agents to implement

02Documenting refactor proposals with explicit code references and dependencies

03Converting a one-sentence bug report into a detailed technical issue

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bendrucker/claude refine-issue

For use in Claude.ai and ChatGPT

Download Skill