issue-writing

Create structured Linear issues with templates and acceptance criteria.

2|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/jclfocused/claude-agents --skill issue-writing-jclfocused
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-writing
Source: https://github.com/jclfocused/claude-agents/tree/main/custom_plugins/plugins/linear-planning-workflow/skills/issue-writing
Command: npx skills add https://github.com/jclfocused/claude-agents --skill issue-writing-jclfocused

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that all issues, from parent features to sub-tasks, are written with exceptional clarity, structure, and completeness, making them actionable for any developer or AI.

Core Features & Use Cases

  • Standardized Issue Structure: Provides templates for both parent feature issues and sub-issues/tasks, ensuring consistency.
  • Actionable Acceptance Criteria: Guides users in writing SMART (Specific, Measurable, Achievable, Relevant, Testable) acceptance criteria.
  • Visual Clarity: Encourages the use of Mermaid diagrams to illustrate flows, states, and relationships.
  • Use Case: When starting a new feature, use this skill to draft a well-defined parent issue and then break it down into smaller, actionable sub-issues with clear acceptance criteria.

Quick Start

Use the issue-writing skill to draft a new parent feature issue for a user login system.

Frequently Asked Questions about issue-writing

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

FAQPage Schema
How do I write actionable Linear issues with clear acceptance criteria?

To write actionable Linear issues, use predefined templates that structure requirements and SMART acceptance criteria. This standardizes task breakdown and ensures issues are self-contained, measurable, and clear for any developer or AI to implement.

What is the best way to break down a parent feature issue into sub-tasks?

The best way to break down a parent feature issue is to use standardized templates for sub-issues that enforce appropriate granularity and self-contained context. This ensures every sub-task has specific, testable acceptance criteria and clear implementation details.

How do I use Mermaid diagrams to visualize project management flows in issue tracking?

Mermaid diagrams visualize project management flows by illustrating states and relationships directly within issue tracking. Adding these visual aids to Linear issues provides clarity on complex feature implementations and task dependencies for the development team.

Can I use this issue-writing approach for both parent features and smaller sub-issues?

Yes, this issue-writing approach provides specific templates for both parent feature issues and smaller sub-issues. This ensures consistent structure, clear requirements, and actionable acceptance criteria across all levels of your software development project tracking.

Why should I standardize task breakdown and documentation for software engineering projects?

Standardizing task breakdown and documentation solves the problem of ambiguous requirements. It ensures all issues are written with exceptional clarity and completeness, making them immediately actionable and reducing communication overhead for software engineering teams.

What should be included in well-structured project management documentation for development tasks?

Well-structured project management documentation should include self-contained context, SMART acceptance criteria, appropriate task granularity, and Mermaid diagrams for visual clarity. This ensures requirements are clearly communicated for any development task.