/itp:release

Delegate to the repository's mise release tasks. Every repo should define its own release DAG in .mise/tasks/release/ .

First Action: Detect Repo's Release Tasks

Check if the repo has mise release tasks

mise tasks ls 2>/dev/null | grep -i release

• If tasks exist: Delegate to mise run release:full (or the repo's equivalent)

• If no tasks: Fall back to reading the semantic-release skill for guidance

Arguments

Flag Short Description

--dry

-d

Dry-run mode (preview, no modifications)

--status

-s

Show current version and release state

Execution

Full release (preflight → version → sync → verify)

mise run release:full

Dry-run (preview what would be released)

mise run release:dry

Check current state

mise run release:status

Why mise Tasks Over Prescriptive Skills

Concern Prescriptive Skill mise Task Delegation

Repo-specific logic Duplicated in skill Lives in .mise/tasks/

DAG enforcement Manual ordering depends array enforced

Maintainability Update skill + tasks Single source in tasks

Portability Assumes npm/bun Uses whatever the repo configures

Secrets Hardcoded patterns [env] in .mise.toml

Expected mise Release Task Structure

Repos should follow the hub-and-spoke pattern:

.mise.toml # Hub: [env] + [tools] + task docs .mise/tasks/ └── release/ ├── _default # Help / navigation ├── preflight # Phase 1: Validate prerequisites ├── version # Phase 2: Bump version (semantic-release) ├── sync # Phase 3: Sync artifacts (marketplace, cache) ├── verify # Phase 4: Verify release artifacts ├── full # Orchestrator: depends on all phases ├── dry # Dry-run preview └── status # Current version info

Task DAG

        ┌──────────┐
        │ preflight│
        └─────┬────┘
              │ depends
        ┌─────▼────┐
        │ version  │
        └─────┬────┘
              │ sequential
        ┌─────▼────┐
        │   sync   │
        └─────┬────┘
              │ sequential
        ┌─────▼────┐
        │  verify  │
        └──────────┘

Key Patterns

.mise/tasks/release/full (orchestrator)

depends = ["release:preflight"]

Chains: preflight → version → sync → verify

.mise/tasks/release/preflight (guard)

Checks: clean dir, auth, plugins, releasable commits

.mise/tasks/release/version (core)

depends = ["release:preflight"]

Runs: semantic-release (or language-specific versioning)

Fallback: No mise Tasks

If the repo has no mise release tasks, read the semantic-release skill:

Read: ${CLAUDE_PLUGIN_ROOT}/skills/semantic-release/SKILL.md Read: ${CLAUDE_PLUGIN_ROOT}/skills/semantic-release/references/local-release-workflow.md

Then follow the 4-phase workflow documented there.

Error Recovery

Error Resolution

mise tasks not found Install mise: curl https://mise.run | sh

No release tasks Create .mise/tasks/release/ or use fallback skill

Working dir not clean git stash or commit changes

Not on main branch git checkout main

No releasable commits Create a feat: or fix: commit first

Wrong account Check GH_TOKEN / GH_ACCOUNT in .mise.toml [env]

Reference

• mise Task Configuration

• Release Workflow Patterns

• semantic-release Skill (fallback)