メニュー
CI/CD pipeline creation, deployment automation, and troubleshooting for GitHub Actions and GitLab CI. Use when user says "CI pipeline", "CD pipeline", "GitHub Actions", "GitLab CI", "deployment automation", "pipeline debugging", "deployment pipeline", "workflow file".
Codebase statistics and technical debt tracking agent.
Dependency analysis agent for detecting circular dependencies and validating architecture layers.
Docker environment validation agent for Stage 5 compliance. Validates Docker availability, captures pre-test state, runs Compose build/deploy, tests HTTP endpoints (authenticated and unauthenticated), detects 4xx/5xx errors, and restores Docker state to pre-test baseline.
Docker image building, container execution, and debugging patterns with security checklists.
Documentation writing skill for creating and editing markdown files. Use when creating, editing, or reviewing documentation files (markdown, MDX, README, guides). Use when the user asks to "write docs", "create documentation", "edit the README", "improve doc clarity", "make docs more readable", "follow the style guide", or "write user-facing content". Applies conversational, clear, and user-focused writing style.
Error handling standardization agent for converting inconsistent error patterns to emit_error().
| name | cicd-workflow |
| description | CI/CD pipeline creation, deployment automation, and troubleshooting for GitHub Actions and GitLab CI. Use when user says "CI pipeline", "CD pipeline", "GitHub Actions", "GitLab CI", "deployment automation", "pipeline debugging", "deployment pipeline", "workflow file". |
| triggers | ["CI pipeline","CD pipeline","GitHub Actions","GitLab CI","deployment automation","pipeline debugging","deployment pipeline","workflow file"] |
Patterns, templates, and references for building CI pipelines, deployment automation, and debugging pipeline issues.
Read all of the following reference files before proceeding with any workflow step:
references/github-actions.md — GitHub Actions patterns and best practices.references/gitlab-ci.md — GitLab CI patterns and best practices.references/deployment-strategies.md — Deployment strategy patterns.references/troubleshooting.md — Common CI/CD issues and solutions.This skill provides:
This skill is referenced by:
ALL pipelines MUST be fast, reliable, secure, and provide clear feedback.
| Parameter | Description | Required |
|---|---|---|
{{TASK_ID}} | Current task identifier | Yes |
{{DATE}} | Current date (YYYY-MM-DD) | Yes |
{{SLUG}} | URL-safe topic name | Yes |
{{PLATFORM}} | Target platform (github-actions, gitlab-ci) | Yes |
{{WORKFLOW_TYPE}} | Type of workflow (ci, cd, full) | No |
{{EPIC_ID}} | Parent epic identifier | No |
{{SESSION_ID}} | Session identifier | No |
@_shared/templates/skill-boilerplate.md#task-integration
TaskGetTaskUpdate (status: in_progress){{OUTPUT_DIR}}/{{DATE}}_{{SLUG}}.md{{MANIFEST_PATH}}TaskUpdate (status: completed)# .github/workflows/ci.yml
name: CI
on:
push:
branches: [main, develop]
pull_request:
branches: [main]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm'
- run: npm ci
- run: npm run lint
- run: npm test
- run: npm run build
# .gitlab-ci.yml
stages:
- build
- test
- deploy
build:
stage: build
image: node:20
script:
- npm ci
- npm run build
artifacts:
paths:
- dist/
test:
stage: test
image: node:20
script:
- npm ci
- npm test
deploy:
stage: deploy
script:
- ./deploy.sh
only:
- main
+---------+ +---------+ +---------+ +---------+
| Lint |-->| Build |-->| Test |-->| Security|
+---------+ +---------+ +---------+ +---------+
+---------+ +---------+ +---------+ +---------+
| CI |-->| Dev |-->| Staging |-->| Prod |
| Build | | Deploy | | Deploy | | Deploy |
+---------+ +---------+ +---------+ +---------+
| | |
v v v
Auto on Auto on Manual
develop main Approval
| Strategy | Description | Risk | Downtime |
|---|---|---|---|
| Rolling | Gradual replacement | Low | None |
| Blue/Green | Full environment swap | Medium | None |
| Canary | Small % first | Low | None |
| Recreate | Stop old, start new | High | Yes |
| Language | Cache Key | Cache Path |
|---|---|---|
| Node.js | package-lock.json | ~/.npm |
| Python | requirements.txt | ~/.cache/pip |
| Java | pom.xml/build.gradle | ~/.m2/~/.gradle |
| Go | go.sum | ~/go/pkg/mod |
| Rust | Cargo.lock | ~/.cargo |
@_shared/templates/skill-boilerplate.md#subagent-protocol
Summary message: "CI/CD workflow complete. See MANIFEST.jsonl for summary."
Write to {{OUTPUT_DIR}}/{{DATE}}_{{SLUG}}.md:
# CI/CD Workflow Report: {{SLUG}}
## Summary
- **Platform:** {{PLATFORM}}
- **Workflow Type:** {{CI|CD|FULL}}
- **Status:** {{SUCCESS|PARTIAL|BLOCKED}}
## Configuration
### Workflow File
{{Workflow file content or path}}
## Pipeline Stages
| Stage | Description | Status |
|-------|-------------|--------|
| {{Stage}} | {{Description}} | {{PASS|FAIL|SKIP}} |
## Security Checklist Results
| Check | Status | Notes |
|-------|--------|-------|
| {{Check}} | {{PASS|FAIL}} | {{Notes}} |
## Recommendations
1. {{Recommendation 1}}
2. {{Recommendation 2}}
## Linked Tasks
- Epic: {{EPIC_ID}}
- Task: {{TASK_ID}}
@_shared/templates/skill-boilerplate.md#manifest-entry
CI/CD-specific fields:
key_findings: Pipeline configuration and security checklist resultsactionable: true if security issues or optimizations found@_shared/templates/skill-boilerplate.md#completion-checklist
@_shared/templates/skill-boilerplate.md#error-handling
Skill-specific messages:
claude-code/
└── skills/
└── cicd-workflow/
├── SKILL.md # This file
└── references/
├── github-actions.md
├── gitlab-ci.md
├── deployment-strategies.md
└── troubleshooting.md
references/github-actions.md - GitHub Actions patterns and best practicesreferences/gitlab-ci.md - GitLab CI patterns and best practicesreferences/deployment-strategies.md - Deployment strategy patternsreferences/troubleshooting.md - Common issues and solutions