| name | ci-cd-release |
| description | Manage CI/CD pipelines, GitHub Actions, build scripts, changelog, and release workflows. Trigger on /ci-cd-release, or when editing workflows, releasing, fixing CI failures, or creating changelogs. |
| user-invocable | true |
| allowed-tools | Read, Grep, Glob, Bash, Edit |
CI/CD Release
Handle CI/CD, build pipelines, and releases safely. CI/CD is high-risk — mistakes block the whole team.
Workflow
1. Understand the pipeline
- Read the workflow file (
.github/workflows/, .gitlab-ci.yml, etc.).
- Identify triggers (push, PR, tag, schedule, manual).
- Understand the stages (lint, test, build, deploy).
- Note which secrets/env vars are required.
2. CI failure diagnosis
- Reproduce locally if possible (same Node/Bun version, same OS).
- Check if the failure is pre-existing (failing before your change).
- Look at CI logs — find the exact command and error, not just the red status.
- Distinguish: infra failure (runner, cache, timeout) vs code failure.
3. Release workflow
- Confirm the release checklist (tests pass, changelog updated, version bumped).
- Use the project's release script or convention — do not invent a new process.
- If tagging, verify the tag matches the version in package.json.
- If publishing, confirm package contents (files field, dist existence).
4. Changelog
- Read existing changelog format and follow it.
- Categorize changes: Added, Changed, Fixed, Removed, Security.
- Do not overwrite unreleased changes.
Rules
- Do not edit CI workflows that require secrets you cannot verify.
- Do not trigger releases without explicit confirmation.
- Document CI env vars (without exposing values).
- Test workflow changes on a branch first, not main.
Experience Log
This skill learns from experience. Mechanism:
- Read
.claude/experience/'"$s"'.md at skill start to benefit from past lessons.
- Write to
.claude/experience/'"$s"'.md after use if you learned something new.
- Format:
YYYY-MM-DD: <lesson> — one line per entry.
- Evolve: If the same issue repeats 3+ times, update this SKILL.md itself.
