# Speckit Workflow

> Manage and run Spec Kit automation workflows via `specify workflow`. USE FOR: running a workflow by ID or local YAML, resuming a paused/failed run, checking run status, listing/installing/removing workflows, searching the workflow catalog, showing a workflow step graph. DO NOT USE FOR: extensions (use speckit-extension), presets (use speckit-preset), or bundles (use speckit-bundle).

- Skill: `github/speckit-workflow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add github/speckit-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/github/speckit-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: GitHub (Microsoft) (https://skillmd.com/u/github)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/github/speckit-workflow

---


# Spec Kit — workflows

Run and manage spec-kit automation workflows with the **Specify CLI**
`specify workflow` command group.

> **Prerequisite:** needs the `specify` CLI. If `specify --version` fails, install it
> with the **speckit-cli-setup** skill first.

## When to use

- Execute a multi-step spec-kit automation workflow.
- Resume a run that paused at a gate or failed, or check its status.
- Discover, install, or remove workflows.

## How to invoke

```bash
# Discover
specify workflow list
specify workflow search <query>
specify workflow info <id>             # details and step graph

# Run
specify workflow run <id-or-path>
specify workflow run <id> -i key=value -i other=value   # pass inputs
specify workflow run <id> --json                        # machine-readable outcome

# Resume / status
specify workflow status <run>
specify workflow resume <run>

# Install / remove
specify workflow add <id-or-url-or-path>
specify workflow remove <id>

# Catalogs (sources workflows are resolved from)
specify workflow catalog list
specify workflow catalog add <url> [--name <name>]
specify workflow catalog remove <index>         # by index

# Step types — see the speckit-workflow-step skill
specify workflow step --help
```

## Notes

- `run` accepts either an installed workflow **ID** or a path to a local **YAML** file.
- Pass inputs with repeated `-i key=value` (a.k.a. `--input`) flags.
- Use `--json` when you need to parse the run outcome programmatically; surface a
  human summary to the user afterward.
- If a run stops at a gate, use `specify workflow resume` rather than re-running
  from the start.
- To manage the **step types** workflows are built from, use the
  **speckit-workflow-step** skill.