write-linear-project

Creates and updates Linear Projects after draft confirmation and read-only verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Making changes to Linear Projects by hand through ad-hoc prompts risks writing to the wrong project, skipping confirmation, or losing track of what changed. This Skill enforces a safe, structured workflow for creating and updating Linear Projects with explicit draft approval before any write occurs. ## Core Features & Use Cases - Draft-before-write workflow: Presents a structured draft covering operation, target, changes, and reason, and only writes after explicit user approval. - Scoped Project management: Handles Project name, description, status, lead, members, teams, roadmap, target date, and links, while delegating issues and milestones to dedicated skills. - Authentication failure handling: Detects OAuth and reauthentication errors during read-only checks and stops instead of attempting workaround writes. - Use Case: You need to create a new Linear Project for a Q3 initiative. The Skill verifies the target team, drafts the Project with a structured description template (background, goals, scope, milestones), waits for your approval, then writes it and returns the Linear link. ## Quick Start Use the write-linear-project skill to create a new Linear Project in the platform team with a draft for my review before writing.

Frequently Asked Questions about write-linear-project

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

FAQPage Schema
How do I create a Linear Project with confirmation before writing?▼

This Skill drafts the Project operation first, showing the target, changes, and reason, then writes only after you explicitly approve. It verifies the target team or Project with a read-only check before drafting.

How to update Linear Project status, lead, or target date?▼

Specify the Project URL or name plus the fields to change, such as status, lead, members, roadmap, or target date. The Skill presents a draft of the changes and applies them to Linear only after your approval.

Can this skill update individual Linear issues or milestones?▼

No, individual issue creation and updates are handled by the write-linear-issue skill, and milestone changes belong to write-linear-milestone. This skill is scoped strictly to Project-level fields.

What happens when Linear OAuth authentication expires during a write?▼

If a read-only check returns 401, reauthentication, or invalid grant errors, the Skill stops before drafting or writing and asks you to reauthenticate. It does not attempt alternative write paths or workarounds.

Does the skill write to Linear without explicit approval?▼

No, it never writes without explicit user approval of the presented draft. It also refuses credentials such as tokens, OAuth codes, API keys, or cookies, and does not auto-update vault Project notes.