---
name: aiskillstore-linear-milestones-write
description: "Create and update Linear project milestones via CLI (write operations)"
license: "MIT"
metadata:
  decimalai-skill-id: "93b0eac0-77f2-4d62-87b5-a60aebb06adf"
  decimalai-version-id: "fdca644c-43e2-4b66-8439-6dd66ec0017a"
  decimalai-version: "1"
  decimalai-body-sha256: "667b47d8b5d7a8abf881ac9451057fc42e5dca8e2a5c64eb80fa87c36598edac"
  decimalai-name: "aiskillstore/linear-milestones-write"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "productivity"
  decimalai-source: "https://app.decimal.ai/s/aiskillstore-linear-milestones-write@1/SKILL.md"
---
## Overview

CLI tools for creating and updating Linear project milestones. Requires `LINEAR_API_KEY` set in `<git-root>/.env` or exported in the environment.

## Prerequisites

- [bun](https://bun.sh) runtime installed
- `LINEAR_API_KEY` set in `<git-root>/.env` or environment

## Commands

### Create Milestone

```bash
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "..." --project "..." [options]
```

**Required:**
- `--name <name>` - Milestone name
- `--project <name>` - Project name or UUID

**Options:**
- `--description <text>` - Milestone description
- `--target-date <date>` - Target date (YYYY-MM-DD)
- `--json` - Output as JSON

**Examples:**
```bash
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "Alpha Release" --project "Mount Vernon"
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "Beta" --project "Monticello" --target-date 2025-02-01
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "GA" --project "Hermitage" --description "General availability release"
```

---

### Update Milestone

```bash
bun .opencode/skill/linear-milestones-write/update-milestone.js <milestone-id> [options]
```

**Arguments:**
- `milestone-id` - Milestone UUID

**Options:**
- `--name <name>` - New milestone name
- `--description <text>` - New description
- `--target-date <date>` - New target date (YYYY-MM-DD)
- `--json` - Output as JSON

**Examples:**
```bash
bun .opencode/skill/linear-milestones-write/update-milestone.js abc123 --name "Beta Release"
bun .opencode/skill/linear-milestones-write/update-milestone.js abc123 --target-date 2025-03-15
bun .opencode/skill/linear-milestones-write/update-milestone.js abc123 --name "v1.0" --target-date 2025-04-01
```

---

## Notes

- Project names support partial matching (case-insensitive)
- Milestone IDs are UUIDs (use `list-milestones.js` to find them)
- Use `--json` flag for machine-readable output
- All commands support `--help` for detailed usage information