← ClaudeAtlas

gsd-to-linearlisted

Migrate a repo's GSD (.planning/) data to Linear issues. Use this skill when the user wants to transition from GSD to Linear, move planning data to Linear, import GSD phases into Linear, or asks about migrating their .planning/ directory. Also triggers on "migrate to linear", "move GSD to linear", "import planning to linear", or any mention of converting GSD phases/plans into Linear issues. Only relevant for repos that have a .planning/ directory.
Manzanita-Research/magpie · ★ 3 · Data & Documents · score 66
Install: claude install-skill Manzanita-Research/magpie
# GSD to Linear Migration This skill reads a repo's `.planning/` directory and creates corresponding Linear issues for any incomplete work. It's a one-time migration — run it once per repo, then use the `linear-workflow` skill going forward. ## Command reference All linctl commands used by this skill are documented in `plugins/linear/LINCTL_REFERENCE.md`. Read it before running any linctl commands — it has exact flags and gotchas that prevent wasted calls. ## Before you start 1. Confirm linctl is authenticated: `linctl whoami` 2. Check that a `.planning/` directory exists in the current repo 3. Read `.planning/STATE.md` to understand where things stand 4. Discover the workspace: ```bash linctl team list --json linctl label list --team <TEAM_KEY> --json ``` If there's only one team, use it. If multiple, ask the user which one. ## What migrates (and what doesn't) **Migrates:** - Incomplete phases and their plans → Linear issues - PROJECT.md context → Linear project description - Phase-level acceptance criteria → issue descriptions - Requirements not yet satisfied → issue descriptions **Stays behind (already done, or not task data):** - Completed plans with SUMMARY.md files — these are history - STATE.md — Linear tracks state natively - config.json — agent execution settings, not task metadata - RESEARCH.md / CONTEXT.md — reference material, not actionable work - Completed milestones documented in MILESTONES.md — retrospectives, not tickets The goal is to move *remain