write-linear-milestone

Creates and updates Linear project milestones after draft confirmation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing milestones to Linear directly risks mistakes like wrong target dates, broken dependencies, or edits to the wrong project. This Skill enforces a confirm-before-write workflow so every milestone creation or update is reviewed as a draft before anything is committed to Linear. ## Core Features & Use Cases - Draft-first writes: Builds a structured draft (operation, target project, milestone, changes, reason) and only writes to Linear after explicit user approval. - Scoped milestone operations: Handles milestone name, description, target date, sort order, status, and related project changes while delegating issue and project edits to separate skills. - Linear MCP constraint handling: Accounts for known Linear MCP limits, such as milestones having no standalone URL and no delete/archive tool, and guides users to the Web UI when needed. - Use Case: When a project plan shifts, ask the agent to move a milestone's target date. It verifies the project read-only, shows a draft of the change, and writes only after you approve. ## Quick Start Use the write-linear-milestone skill to update the target date of the "Beta Release" milestone in my Linear project to next Friday, showing me a draft first.

Frequently Asked Questions about write-linear-milestone

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

FAQPage Schema
How do I create a milestone in Linear with an AI agent?▼

Provide the target Linear project, milestone name, and desired fields like target date and description. The skill verifies the project read-only, presents a draft of the milestone, and writes it to Linear only after you explicitly approve.

How do I update a Linear milestone target date safely?▼

Specify the project, milestone name, and new target date. The skill checks dependencies and date constraints, shows a draft summarizing the change and reason, and commits the update only after your confirmation.

Can I delete a Linear milestone through the Linear MCP tools?▼

No, Linear MCP provides no delete or archive tool for milestones. The skill directs you to the Linear Web UI for manual deletion and does not attempt workarounds like comment-based invalidation.

Does a Linear milestone have its own URL?▼

No, Linear milestones have no standalone URL, and the get_milestone and save_milestone tools return no link. The skill returns the parent project's URL instead and notes that the milestone itself has no individual link.

What happens if Linear authentication expires during a milestone write?▼

The skill stops immediately on errors like 401 Reauthentication required or oauth_token_invalid_grant and asks you to reauthenticate. It does not fall back to alternate tools or comment-based writes, and you retry the same target after reauthenticating.