Agent skill

Deployment Sop

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

Deployment workflows, pre-deploy validation, and smoke testing patterns.

MITAuto-check: notesDevOps & Cloud

Install Deployment Sop

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/.claude/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
~966 tokens
SKILL.md length
284 words
Files
2
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Deployment workflows, pre-deploy validation, and smoke testing patterns.

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

What it does

Deployment Sop is an agent skill from bybren-llc/safe-agentic-workflow. Deployment workflows, pre-deploy validation, and smoke testing patterns. Use when deploying to staging or production, running smoke tests, or validating deployments.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in DevOps & Cloud, covering Deployment, Operations and SOPs and QA and bug reports. It works with Linux. The repository describes itself as: SAW — SAFe Agentic Workflow AI Agent Harness for Multi-Agent Team Workflows Built on SAFe methodology (Scaled Agile Framework), adapted for AI agent teams (Now With AI-DLC!)… The licence is MIT.

When your agent uses it

  • Deploying to staging
  • Running smoke tests
  • Validating deployments

Example prompts

  • “/deployment-sop”

Requirements

  • Docker
  • Pre-approved tools (allowed-tools): Read, Bash, Grep, Glob

Workflow steps

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

  1. Identify failure - Check Coolify logs, PostHog errors
  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 Linear 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 these tools, so the agent can use them without asking each time:

    • Read
    • Bash
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • yarn
    • 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 yarn, 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 loads about 966 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 284 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, Grep, Glob

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); files beside SKILL.md are not scanned.

SKILL.md

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

Download SKILL.mdSave it as .claude/skills/deployment-sop/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
deployment-sop
description
Deployment workflows, pre-deploy validation, and smoke testing patterns. Use when deploying to staging or production, running smoke tests, or validating deployments.
allowed-tools
Read, Bash, Grep, Glob
disable-model-invocation
true
argument-hint
[environment]

Deployment SOP Skill

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

Invoke this skill when:

  • Deploying to staging or production
  • Running pre-deploy validation
  • Executing post-deploy smoke tests
  • Accessing Linux dev machine for deployment
  • Coordinating release activities

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
Linux Dev Machine Accessdocs/deployment/LINUX-DEV-MACHINE-ACCESS-SOP.mdPop OS dev 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 (dev for staging, master for prod)
  • No unresolved blockers in Linear
  • Database migrations tested locally
  • Environment variables verified
bash
# Validate before deploy
yarn ci:validate
yarn build

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 (PostHog/Coolify)
bash
# Smoke test commands
curl -s https://{domain}/api/health | jq .
# Expected: {"status":"healthy","timestamp":"..."}

Deployment Evidence Template

For Linear 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":"2025-XX-XXTXX:XX:XX.XXXZ"}

Rollback Procedure

If deployment fails:

  1. Identify failure - Check Coolify logs, PostHog errors
  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 Linear 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 → Environment Mapping

BranchEnvironmentAuto-Deploy
devStaging (Pop OS)Manual pull
masterProduction (Coolify)Automatic

Note: Merging to dev builds Docker image but requires manual ./scripts/dev-docker.sh pull on Pop OS.

© 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 1 other file in .claude/skills/deployment-sop of bybren-llc/safe-agentic-workflow.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 26ca58b

Compare with similar skills

Deployment Sop 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deployment Sop this skillbybren-llc/safe-agentic-workflow423—~966Automated safety check: NotesMIT
Canaryatelier-fashion/adlc-toolkit171—~2.2kAutomated safety check: PassMIT
Money Opsiamzifei/show-me-the-money1k—~3.8kAutomated safety check: PassCustom licence
Release Readinesspetrkindlmann/qa-skills170—~6.7kAutomated safety check: PassMIT
Client Onboarding AgentLeoYeAI/openclaw-master-skills2.2k—~4.5kAutomated safety check: PassMIT
Networking DeploymentLunCoSim/lunco-sim107—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Canary

    atelier-fashion/adlc-toolkit

    Canary deployment with smoke tests — deploy to a zero-traffic revision, run health checks, and promote on success.

    171 GitHub stars~2.2k tokensUpdated 11 days ago
    DevOps & CloudAuto-check passed
  • Money Ops

    iamzifei/show-me-the-money

    24/7 autonomous business operations orchestrator with business health scoring, canary monitoring, and safety guardrails.

    1k GitHub stars~3.8k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Release Readiness

    petrkindlmann/qa-skills

    Validate release readiness with evidence-based go/no-go decisions.

    170 GitHub stars~6.7k tokensUpdated 4 mo ago
    DevOps & CloudAuto-check passed
  • Client Onboarding Agent

    LeoYeAI/openclaw-master-skills

    Client onboarding and business diagnostic framework for AI agent deployments.

    2.2k GitHub stars~4.5k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Networking Deployment

    LunCoSim/lunco-sim

    Configure, smoke-test, or deploy LunCoSim networking, the headless server, WebTransport, multiplayer sessions, TLS, or host/client launch.

    107 GitHub stars~1.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Openbkn Deploy

    openbkn-ai/bkn-foundry

    Deploy or upgrade OpenBKN on a customer-authorized Linux server through the repository's deploy scripts, with preflight checks, explicit confirmation, secret handling, and post-deployment…

    655 GitHub stars~1.9k tokensUpdated today
    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
  • Deployment SOP Checklist

    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…

    423 GitHub stars~950 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

Works with

Questions about Deployment Sop

What does Deployment Sop do?

Deployment workflows, pre-deploy validation, and smoke testing patterns. Deployment Sop is an agent skill from bybren-llc/safe-agentic-workflow. Deployment workflows, pre-deploy validation, and smoke testing patterns.

When should I use Deployment Sop?

Deployment Sop fits situations like: deploying to staging; running smoke tests; validating deployments.

How do I install Deployment Sop in Claude Code?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill deployment-sop -a claude-code`. Or copy the skill folder (.claude/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 in Codex?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill deployment-sop -a codex`. Or copy the skill folder (.claude/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 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 need to run?

Going by SKILL.md and its folder, Deployment Sop needs the command-line tools its instructions call (yarn, curl, jq and git). Our summary lists: Docker. Its frontmatter pre-approves these tools: Read, Bash, Grep, Glob.

Does Deployment Sop 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 safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Deployment Sop use?

Deployment Sop 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 use?

About 966 tokens (SKILL.md is roughly 3.9k 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?

Skills that share tags, products or a category with Deployment Sop: Canary (atelier-fashion/adlc-toolkit, 171 stars), Money Ops (iamzifei/show-me-the-money, 1k stars), Release Readiness (petrkindlmann/qa-skills, 170 stars) and Client Onboarding Agent (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deployment Sop?

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.