review-linear-structure

Reviews Linear projects, milestones, and issues against Linear Method principles.

Updated May 18, 2026
One-click install
npx skills add https://github.com/dodonki1223/vault --skill review-linear-structure-dodonki1223
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-linear-structure
Source: https://github.com/dodonki1223/vault/tree/main/.agents/skills/review-linear-structure
Command: npx skills add https://github.com/dodonki1223/vault --skill review-linear-structure-dodonki1223

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Linear workspaces often drift into poorly scoped projects, oversized issues, and milestones that are just date labels. This Skill audits your Linear Projects, milestones, and issues against Linear Method principles so structure stays actionable and readable. ## Core Features & Use Cases - Read-only structural review: Fetches Projects, milestones, and issues via Linear MCP without writing anything back to Linear. - Principle-based checks: Evaluates granularity, scope, completion criteria, description vs. comment usage, and issue decomposition against documented Linear Method principles. - Structured findings: Returns a fixed report format covering strengths, concerns, improvement proposals, and open questions, with a separate failure report when data cannot be fetched. - Use Case: Before a sprint planning session, point the Skill at a Project URL to verify milestones have real outcomes, dependencies are consistent with target dates, and issues are concrete tasks rather than vague ideas. ## Quick Start Review the Linear project at this URL and check whether its milestones and issues follow Linear Method principles.

Frequently Asked Questions about review-linear-structure

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

FAQPage Schema
How do I review Linear project structure against Linear Method?▼

Provide a Linear Project, milestone, or issue URL or ID and the Skill fetches it read-only via the Linear MCP connector. It then checks granularity, scope, completion criteria, and issue decomposition against documented Linear Method principles and returns a structured report.

Can this Skill update Linear issues or post comments?▼

No, the Skill is strictly read-only and never writes to Linear. When changes are needed, it returns improvement proposals only; actual writes are delegated to separate write-focused skills for issues, milestones, and projects.

What does the Linear structure review check in milestones?▼

It verifies milestones are intermediate outcomes with completion criteria rather than date labels, that dependencies and target dates are consistent, and that contained issues directly support the milestone outcome. Complex dependencies may be visualized with Mermaid.

Why did the Linear review return a not-executed report?▼

The review fails when the Linear connector is unavailable, re-authentication is needed, permissions are insufficient, or the target is unknown or missing. The failure report states the reason, what was checked, and the next step for the user.

Does the review cover every issue in a large Linear project?▼

No, for large projects it samples representative issues such as investigation, implementation, bug, and milestone-defining issues. Users can also explicitly request a partial review limited to a subset of issues.