eq-create-issue

Writes Linear issues from conversations or diffs using a two-audience template with checkable acceptance criteria.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/everquint/frontend-skills --skill eq-create-issue-everquint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eq-create-issue
Source: https://github.com/everquint/frontend-skills/tree/main/skills/productivity/eq-create-issue
Command: npx skills add https://github.com/everquint/frontend-skills --skill eq-create-issue-everquint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose detail when tickets are written for only one audience: PMs cannot prioritize tickets full of code nouns, and developers cannot execute tickets with vague acceptance criteria. This Skill writes one Linear issue that serves both, whether the work is about to start or has already shipped without a ticket. ## Core Features & Use Cases - Two branches, one template: An Ahead branch drafts issues from conversation or specs before work starts; a Retro branch reconstructs tickets from the actual git diff for work already merged, linked to the PR. - Plain-language gate: Title, Why, and What changes contain no code nouns, so a PM can judge priority, while Technical notes carry the modules, seams, and contracts a dev needs. - Duplicate and feasibility checks: Searches Linear for existing issues and reads the repo's product docs before writing, so duplicates and infeasible scope are caught early. - Use Case: After merging a PR that fixes lost composer text, ask the agent to file the ticket retroactively — it pins the diff range, writes past-tense acceptance criteria, links the PR, and reports the issue ID for the branch name. ## Quick Start Ask the agent to create a Linear ticket for the work just discussed or for the changes in the current branch's diff.

Frequently Asked Questions about eq-create-issue

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

FAQPage Schema
How do I write a Linear ticket for work that is already merged?

Use the Retro branch: pin the range with git log and git diff, then write only behavior visible in that diff. Fill the Shipped section with the PR link and the verification actually run, create the issue in the team's done state, and link the PR.

How do I write acceptance criteria that developers can execute?

Write each criterion as a checkable statement someone can run and mark pass or fail, one per distinct behavior. "An upload that fails twice shows the retry banner" works; "handles errors correctly" does not.

Should a Linear ticket include file paths or code snippets?

No. File paths and code snippets go stale within a sprint and mislead readers. The one exception is a schema, type shape, or state machine that encodes a decision more precisely than prose, inlined and trimmed to the decision.

What should I check before creating a new Linear issue?

Search Linear for an existing issue covering the work and update it instead of duplicating. Read the repo's product docs to confirm the capability does not already exist and the constraints allow it, and read the team's real statuses, labels, and projects from Linear.

When should a ticket be split into multiple Linear issues?

Split when the work exceeds one vertical slice — a complete, demoable path through every layer it touches that fits one working session. Create the tickets blockers-first using Linear's native blocking relation so the dependency links resolve.