cy-issue-to-spec

Featured

Publishes a Compozy spec set to compozy-specs and mirrors it into a GitHub + Linear issue pair — or starts from a bare issue and authors the spec first.

AI & Automation 2,894 stars 189 forks Updated today MIT

Install

View on GitHub

Quality Score: 96/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Issue ↔ Spec One feature lives in three places: the working **spec set** under `.compozy/tasks/<slug>/`, its published folder in the `compozy/compozy-specs` repo, and its **mirror** — a GitHub issue and a Linear issue that read identically. This skill moves a feature between those places and leaves all three agreeing. ## Branches | Starting point | Enter at | | --- | --- | | A spec set already exists under `.compozy/tasks/<slug>/` | Step 1 | | A GitHub issue exists carrying no spec behind it | Step 0 | ## Step 0 — Author the spec Only when starting from a bare issue. Read the issue and restate its scope in one sentence. When it bundles separable features, split it first: retitle the original to the narrower scope, open a second issue for the remainder, and cross-link both — then spec one of them. Activate `cy-create-spec` with `docs/_memory/spec-authoring-playbook.md`. It writes `_slices.md` and offers peer review after the user approves the spec. *Done when:* `.compozy/tasks/<slug>/` holds `_spec.md` (or `_prd.md` + `_techspec.md`), its companions, `adrs/`, and `_slices.md`, and the user has approved the spec. ## Step 1 — Stage the spec set Run the staging helper (**mutating** — writes into the specs repo working tree): ```bash python3 .agents/skills/cy-issue-to-spec/scripts/publish-spec.py \ --spec-dir .compozy/tasks/<slug> \ --specs-repo <specs-repo-checkout> \ --repo-root "$(pwd)" ``` It publishes `_*.md`, `task_NN.md`, and `adrs/*.md`; it leaves `anal...

Details

Author
compozy
Repository
compozy/compozy
Created
7 months ago
Last Updated
today
Language
Go
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category