linear-refine

Refine Linear issues by enhancing titles, descriptions, and metadata via AI interview.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/macintacos/dotfiles --skill linear-refine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-refine
Source: https://github.com/macintacos/dotfiles/tree/main/managed/private_dot_claude/skills/linear-refine
Command: npx skills add https://github.com/macintacos/dotfiles --skill linear-refine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of updating and improving existing issues within Linear by leveraging AI to refine their title, description, and metadata.

Core Features & Use Cases

  • Issue Refinement: Automatically enhances the clarity and completeness of Linear issues.
  • Metadata Optimization: Suggests and updates labels, priorities, and milestones for better organization.
  • Use Case: You have a Linear issue with a vague description. Use this Skill to have the AI interview you for more details, then rewrite the description and suggest relevant labels and a priority.

Quick Start

Use the linear-refine skill to refine the Linear issue with the identifier ABC-123.

Frequently Asked Questions about linear-refine

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

FAQPage Schema
How do I use AI to refine existing Linear issues?

To refine Linear issues with AI, the Skill fetches current issue details, conducts an interview for context, rewrites the title and description, suggests metadata updates, and applies changes via the Linear API after user approval.

Can I automatically update issue metadata like labels and priorities in Linear?

Yes, updating Linear issue metadata is supported by suggesting and applying optimized labels, priorities, and milestones to enhance organization after an AI-driven interview process.

What is the process for improving vague Linear issue descriptions?

Improving vague Linear descriptions involves the AI interviewing you for missing details, rewriting the content for clarity and completeness, and presenting a draft for your final approval.

Do I need to approve AI suggestions before they update my Linear issues?

Yes, user approval is required before applying any updates, ensuring you review the crafted title, description, and metadata suggestions before they are submitted to the Linear API.

Does this Skill work with newly created Linear tickets or only existing ones?

This Skill works exclusively with existing Linear issues, fetching their current details to enhance titles, descriptions, and metadata rather than creating new tickets from scratch.

What is the best way to add missing context to Linear issues for project management?

The best way to add missing context is through an AI-driven interview that gathers additional details, crafts improved content, and updates the issue metadata for better project tracking.