Agent skill

Deployment SOP Checklist

by bybren-llc in bybren-llc/safe-agentic-workflow

“Deployment workflows, pre-deploy validation, smoke testing, and rollback procedures. Use when deploying to staging or production, running smoke tests, validating deployments, or…”

— description from SKILL.md by bybren-llc
MITAuto-check passedDevOps & Cloud

Install Deployment SOP Checklist

skills CLI
$ npx skills add bybren-llc/safe-agentic-workflow --skill deployment-sop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bybren-llc/safe-agentic-workflow deployment-sop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bybren-llc/safe-agentic-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/deployment-sop .claude/skills/deployment-sop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
deployment-sop
GitHub stars
423
Token cost
~950 tokens
SKILL.md length
262 words
Files
4 (incl. scripts, references, assets)
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 5 steps: Identify failure - Check deployment… → Revert commit - git revert {commit_sha} → Push revert - Triggers automatic… → …
  • SKILL.md covers Purpose, When This Skill Applies, Authoritative References (MUST… and Pre-Deployment Checklist, plus 5 more sections
  • Calls curl, jq and git

About this skill

“Deployment workflows, pre-deploy validation, smoke testing, and rollback procedures. Use when deploying to staging or production, running smoke tests, validating deployments, or planning rollback. Do NOT use for local development or CI pipeline configuration.”

— description from SKILL.md by bybren-llc

Deployment SOP Checklist is a skill in bybren-llc/safe-agentic-workflow (423 stars). Its SKILL.md is about 950 tokens, with 3 other files in the folder (scripts, references, assets). Licence: MIT.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify failure - Check deployment logs, error tracking
  2. Revert commit - git revert {commit_sha}
  3. Push revert - Triggers automatic rollback deployment
  4. Verify rollback - Run smoke tests again
  5. Document incident - Update ticket with evidence

What it can do on your machine

Read from SKILL.md and the folder at commit 26ca58b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • jq
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deployment SOP Checklist loads about 950 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~950

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from bybren-llc/safe-agentic-workflow at commit 26ca58b, republished under its MIT licence (© bybren-llc). 262 words, ~950 tokens.

Download SKILL.mdSave it as .claude/skills/deployment-sop/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
deployment-sop
description
Deployment workflows, pre-deploy validation, smoke testing, and rollback procedures. Use when deploying to staging or production, running smoke tests, validating deployments, or planning rollback. Do NOT use for local development or CI pipeline configuration.

Deployment SOP Skill

TEMPLATE: This skill uses {{PLACEHOLDER}} tokens. Replace with your project values before use.

Purpose

Route to existing deployment SOPs and provide checklists for safe, validated deployments. This skill does NOT duplicate SOP content -- it links to authoritative sources.

When This Skill Applies

  • Deploying to staging or production
  • Running pre-deploy validation
  • Executing post-deploy smoke tests
  • Coordinating release activities
  • Planning rollback procedures

Authoritative References (MUST READ)

DocumentLocationPurpose
Semantic Release SOPdocs/ci-cd/Semantic-Release-Deployment-SOP.mdRelease automation workflow
Staging/UAT Release SOPdocs/sop/STAGING-UAT-RELEASE-SOP.mdUAT validation process
Dev Machine Accessdocs/deployment/LINUX-DEV-MACHINE-ACCESS-SOP.mdDev server access
Production Server Accessdocs/deployment/PRODUCTION-SERVER-ACCESS-SOP.mdProduction deployment

Pre-Deployment Checklist

Before ANY deployment:

  • All CI checks pass (GitHub Actions green)
  • PR merged to target branch
  • No unresolved blockers in ticket system
  • Database migrations tested locally
  • Environment variables verified
bash
# Validate before deploy
{{CI_VALIDATE_COMMAND}}
{{BUILD_COMMAND}}

Post-Deployment Smoke Test

After deployment completes:

  • Health endpoint responds: curl https://{{DOMAIN}}/api/health
  • Database connection verified (check health response)
  • Authentication flow works (sign-in/sign-up)
  • Critical user flows functional
  • No new errors in logs
bash
# Smoke test commands
curl -s https://{{DOMAIN}}/api/health | jq .
# Expected: {"status":"healthy","timestamp":"..."}

Deployment Evidence Template

For ticket attachment:

markdown
## Deployment Evidence - {{TICKET_PREFIX}}-XXX

### Environment
- **Target**: Staging / Production
- **Branch**: `{branch_name}`
- **Commit**: `{commit_sha}`

### Pre-Deployment
- [x] CI checks passed
- [x] PR merged
- [x] Migrations verified

### Post-Deployment
- [x] Health check: PASSED
- [x] Auth flow: PASSED
- [x] Smoke tests: PASSED

### Verification
curl -s https://{{DOMAIN}}/api/health
{"status":"healthy","timestamp":"..."}

Rollback Procedure

If deployment fails:

  1. Identify failure - Check deployment logs, error tracking
  2. Revert commit - git revert {commit_sha}
  3. Push revert - Triggers automatic rollback deployment
  4. Verify rollback - Run smoke tests again
  5. Document incident - Update ticket with evidence

Stop-the-Line Conditions

FORBIDDEN
  • Deploying with failing CI checks
  • Skipping smoke tests on production
  • Deploying database migrations without local testing
  • Force-deploying over active incidents
REQUIRED
  • Health check MUST pass within 5 minutes
  • Production deployments MUST have staging validation first
  • Rollback plan MUST be documented before production deploy

Branch to Environment Mapping

BranchEnvironmentAuto-Deploy
devStaging{{STAGING_DEPLOY_MODE}}
{{MAIN_BRANCH}}Production{{PROD_DEPLOY_MODE}}

© bybren-llc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references, assets) in .agents/skills/deployment-sop of bybren-llc/safe-agentic-workflow.

  • SKILL.md
  • assets/.gitkeep
  • references/.gitkeep
  • scripts/.gitkeep

Open the folder on GitHubat commit 26ca58b

Compare with similar skills

Deployment SOP Checklist next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Deployment SOP Checklist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deployment SOP Checklist this skillbybren-llc/safe-agentic-workflow423—~950Automated safety check: PassMIT
Agr Releasecomputerlovetech/agr451—~1.6kAutomated safety check: PassMIT
OpenWork Release Processdifferent-ai/openwork24k—~2.3kAutomated safety check: PassCustom licence
Deploy QAhmislk/hmis236—~394Automated safety check: NotesGPL-3.0
Vercel CI Integrationjeremylongshore/tons-of-skills-marketplace2.8k—~1.9kAutomated safety check: PassMIT
Adf MasterKilo-Org/kilo-marketplace190—~3.2kAutomated safety check: PassMIT

Similar skills

  • Agr Release

    computerlovetech/agr

    Release process for the agr package. An agent skill from computerlovetech/agr.

    451 GitHub stars~1.6k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • OpenWork Release Process

    different-ai/openwork

    Cuts an OpenWork desktop release through a tag-driven GitHub Actions workflow that makes no commits, with pre-tag checks on open fix PRs and verification afterward.

    24k GitHub stars~2.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Deploy QA

    hmislk/hmis

    Deploy to QA environment (QA1 or QA2). An agent skill from hmislk/hmis.

    236 GitHub stars~394 tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Vercel CI Integration

    jeremylongshore/tons-of-skills-marketplace

    Configure Vercel CI/CD with GitHub Actions, preview deployments, and automated testing.

    2.8k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Adf Master

    Kilo-Org/kilo-marketplace

    Azure Data Factory (ADF) CI/CD, deployment, and pipeline development.

    190 GitHub stars~3.2k tokensUpdated 11 days ago
    DevOps & CloudAuto-check passed
  • CI Failure Triage and Repair

    Chachamaru127/claude-code-harness

    Diagnoses failing CI pipelines and tests, deciding first whether the test or the implementation is at fault, and hands hard cases to a dedicated fixer subagent.

    3.2k GitHub starsUsed in 1 repo~1.1k tokens
    DevOps & CloudAuto-check: notes

More from bybren-llc/safe-agentic-workflow

All 42 skills in this repo
  • Multi-Agent Coordination Template

    bybren-llc/safe-agentic-workflow

    Agent assignment matrix, blocker escalation, and TDM coordination patterns. Use when assigning work to specialist agents, managing blockers across agents…

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • API Route Patterns

    bybren-llc/safe-agentic-workflow

    API route implementation patterns with RLS, validation, and error handling. Use when creating API routes, implementing CRUD endpoints, adding server-side…

    423 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Technical Documentation Templates

    bybren-llc/safe-agentic-workflow

    Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records, writing…

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Frontend Patterns Template

    bybren-llc/safe-agentic-workflow

    Frontend patterns for modern web frameworks, component libraries, auth flows, and analytics. Use when building UI components, creating pages, implementing…

    423 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Advanced Git Operations

    bybren-llc/safe-agentic-workflow

    Advanced git operations including rebase, bisect, cherry-pick, and conflict resolution. Use when rebasing feature branches, debugging with bisect…

    423 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Linear Ticket SOP

    bybren-llc/safe-agentic-workflow

    Ticket management best practices for Linear or equivalent project tracker. Use when creating issues, updating ticket status, attaching evidence, parsing…

    423 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Deployment SOP Checklist

How do I install Deployment SOP Checklist in Claude Code?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill deployment-sop -a claude-code`. Or copy the skill folder (.agents/skills/deployment-sop in bybren-llc/safe-agentic-workflow) into .claude/skills/deployment-sop in your project. Claude Code loads it when a task matches its description.

How do I install Deployment SOP Checklist in Codex?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill deployment-sop -a codex`. Or copy the skill folder (.agents/skills/deployment-sop in bybren-llc/safe-agentic-workflow) into .agents/skills/deployment-sop in your project. Codex loads it when a task matches its description.

Can I use Deployment SOP Checklist in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bybren-llc/safe-agentic-workflow --skill deployment-sop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deployment-sop, .gemini/skills/deployment-sop, .github/skills/deployment-sop and .opencode/skills/deployment-sop in your project.

What does Deployment SOP Checklist need to run?

Going by SKILL.md and its folder, Deployment SOP Checklist needs the command-line tools its instructions call (curl, jq and git).

Does Deployment SOP Checklist access the network?

SKILL.md contains no URLs. Its commands use curl and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Deployment SOP Checklist safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Deployment SOP Checklist use?

Deployment SOP Checklist is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deployment SOP Checklist use?

About 950 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Deployment SOP Checklist?

Skills that share tags, products or a category with Deployment SOP Checklist: Agr Release (computerlovetech/agr, 451 stars), OpenWork Release Process (different-ai/openwork, 24k stars), Deploy QA (hmislk/hmis, 236 stars) and Vercel CI Integration (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deployment SOP Checklist?

bybren-llc (a GitHub organization) maintains it in bybren-llc/safe-agentic-workflow, which has 423 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on July 20, 2026.

Source: bybren-llc/safe-agentic-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.