How do I install the Linear Issue Spec skill?

Run npx skillmds@latest add lmaick/linear-issue-spec in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Linear Issue Spec safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Linear Issue Spec?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Linear Issue Spec free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Linear Issue Spec?

lMaick (@lmaick) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Linear Issue Spec by lmaick — Agent Skill

Name: Linear Issue Spec
Rating: 4.5 (4 reviews)
Author: lMaick

Linear Issue Spec

Especialista em decomposição de produto e escrita de issues no Linear para orquestração de IAs e humanos. Padroniza especificações com escopo cirúrgico, não-escopo explícito, critérios de aceite Gherkin e vinculação de skills do repositório agent-skills.

lMaick Updated Sep 22, 2026

File contents

📐 Linear Issue Specification Standard

Esta skill rege a criação e refinamento de issues no Linear para garantir que qualquer agente ou desenvolvedor entenda exatamente o que deve ser entregue, sem ambiguidades ou alucinações.

🏛️ Princípios de uma Boa Issue para Agentes

Contexto Antes do Código: Explique o "porquê" (a dor do usuário final) antes do "o quê".
Não-Escopo Explícito: Declarar o que NÃO deve ser feito é tão importante quanto o que deve ser feito. Isso previne que a IA tente refatorar o projeto inteiro.
Skill Obrigatória Indicada: Toda issue técnica ou de marketing deve apontar explicitamente qual skill de agent-skills guia a execução.
Critérios de Aceite Verificáveis: Use formato checklist objetivo ou sintaxe Gherkin (Dado que... Quando... Então...).

📋 Template Padrão de Issue no Linear

### 🎯 Objetivo
[Descrição em 1 ou 2 frases do resultado esperado e valor entregue].

---

### 🏥 Contexto de Negócio / Clínico
[Qual é a dor real do usuário que motivou essa demanda? Onde isso impacta a rotina?].

---

### 🛠️ Skills Obrigatórias (`agent-skills`)
* **Skill Principal:** `skills/frontend/impeccable/SKILL.md`
* **Skill Complementar:** `skills/frontend/design-motion-principles/SKILL.md`

---

### 📂 Escopo Técnico & Arquivos Impactados
* **Criar:** `src/components/features/NovoComponente.tsx`
* **Modificar:** `src/lib/modulo/dal.ts` (adicionar função `getResumoFinanceiro`)
* **Testes:** `tests/e2e/novo-fluxo.spec.ts`

---

### 🚫 Não-Escopo (O que NÃO fazer)
* NÃO alterar schemas de banco de dados ou migrations existentes.
* NÃO modificar a navegação global (`Navbar.tsx` ou `Sidebar.tsx`).
* NÃO instalar dependências externas sem alinhamento prévio.

---

### ✅ Critérios de Aceite (Definition of Done)
- [ ] **Critério 1**: Dado um usuário logado com plantões pendentes, quando abrir a tela, deve ver o card com saldo recalculado em tempo real.
- [ ] **Critério 2**: Em conexões lentas, deve exibir skeleton screen proporcional (sem spinner isolado ou tela branca).
- [ ] **Critério 3**: Área de toque móvel nos botões de ação possui no mínimo 44x44px.
- [ ] **Critério 4**: CI passa 100% verde (`npm run lint`, `npx tsc --noEmit`, `npm test`).

---

### 📦 Protocolo de Retorno
Ao concluir, comente nesta issue no formato:
`[DELIVERY] @Orquestrador: Resumo da entrega, branch/PR criada e status dos testes.`

✅ Checklist do Orquestrador antes de Publicar a Issue

O título segue Conventional Commits (ex: feat(financeiro): card de saldo, fix(auth): redirect mobile)?
Os labels corretos de Setor (setor:dev, setor:marketing) e Prioridade foram aplicados?
A skill necessária do agent-skills foi linkada?
Os critérios de aceite são testáveis de forma binária (passou ou não passou)?

---name: linear-issue-specdescription: Especialista em decomposição de produto e escrita de issues no Linear para orquestração de IAs e humanos. Padroniza especificações com escopo cirúrgico, não-escopo explícito, critérios de aceite Gherkin e vinculação de skills do repositório agent-skills.---# 📐 Linear Issue Specification StandardEsta skill rege a criação e refinamento de issues no Linear para garantir que qualquer agente ou desenvolvedor entenda exatamente o que deve ser entregue, sem ambiguidades ou alucinações.---## 🏛️ Princípios de uma Boa Issue para Agentes1. **Contexto Antes do Código**: Explique o "porquê" (a dor do usuário final) antes do "o quê".2. **Não-Escopo Explícito**: Declarar o que **NÃO** deve ser feito é tão importante quanto o que deve ser feito. Isso previne que a IA tente refatorar o projeto inteiro.3. **Skill Obrigatória Indicada**: Toda issue técnica ou de marketing deve apontar explicitamente qual skill de `agent-skills` guia a execução.4. **Critérios de Aceite Verificáveis**: Use formato checklist objetivo ou sintaxe Gherkin (`Dado que... Quando... Então...`).---## 📋 Template Padrão de Issue no Linear```markdown### 🎯 Objetivo[Descrição em 1 ou 2 frases do resultado esperado e valor entregue].---### 🏥 Contexto de Negócio / Clínico[Qual é a dor real do usuário que motivou essa demanda? Onde isso impacta a rotina?].---### 🛠️ Skills Obrigatórias (`agent-skills`)* **Skill Principal:** `skills/frontend/impeccable/SKILL.md`* **Skill Complementar:** `skills/frontend/design-motion-principles/SKILL.md`---### 📂 Escopo Técnico & Arquivos Impactados* **Criar:** `src/components/features/NovoComponente.tsx`* **Modificar:** `src/lib/modulo/dal.ts` (adicionar função `getResumoFinanceiro`)* **Testes:** `tests/e2e/novo-fluxo.spec.ts`---### 🚫 Não-Escopo (O que NÃO fazer)* NÃO alterar schemas de banco de dados ou migrations existentes.* NÃO modificar a navegação global (`Navbar.tsx` ou `Sidebar.tsx`).* NÃO instalar dependências externas sem alinhamento prévio.---### ✅ Critérios de Aceite (Definition of Done)- [ ] **Critério 1**: Dado um usuário logado com plantões pendentes, quando abrir a tela, deve ver o card com saldo recalculado em tempo real.- [ ] **Critério 2**: Em conexões lentas, deve exibir skeleton screen proporcional (sem spinner isolado ou tela branca).- [ ] **Critério 3**: Área de toque móvel nos botões de ação possui no mínimo 44x44px.- [ ] **Critério 4**: CI passa 100% verde (`npm run lint`, `npx tsc --noEmit`, `npm test`).---### 📦 Protocolo de RetornoAo concluir, comente nesta issue no formato:`[DELIVERY] @Orquestrador: Resumo da entrega, branch/PR criada e status dos testes.````---## ✅ Checklist do Orquestrador antes de Publicar a Issue- [ ] O título segue Conventional Commits (ex: `feat(financeiro): card de saldo`, `fix(auth): redirect mobile`)?- [ ] Os labels corretos de Setor (`setor:dev`, `setor:marketing`) e Prioridade foram aplicados?- [ ] A skill necessária do `agent-skills` foi linkada?- [ ] Os critérios de aceite são testáveis de forma binária (passou ou não passou)?

Frequently asked questions