About

Imported from shipshitdev/skills (skills/deploy/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill deploy. Copyright stays with the author.

Deploy

Name: deploy
Author: shipshitdev

Contract

Inputs:

Repository root
Target environment: preview, staging, or production
Optional branch, PR number, deployment provider, and health-check URL

Outputs:

Pre-deploy gate results
Deployment route and provider
Verification status
Rollback or follow-up instructions when needed

Creates/Modifies:

Local changes only when fixing failed gates before deployment
Release PRs only when delegated to release-pr-gates

External Side Effects:

May trigger provider deployments
May create or update GitHub PRs through delegated release skills
May read logs and monitoring systems

Confirmation Required:

Before production deploys
Before merging release PRs
Before rollback commands
Before force-pushes or history rewriting

Delegates To:

deployment-composer for route discovery across providers
release-pr-gates for branch promotion PRs
github-fix-ci for failed GitHub Actions checks
ec2-backend-deployer for EC2/Docker deployment setup

When to Use

Deploying to staging or production
Setting up deployment pipelines
Managing environment-specific deployments

Local Quality Gates (MANDATORY)

Always run format, lint, and type-check locally before every release PR or deployment. These mirror the expected GitHub Actions gates and are cheap enough to run before pushing.

Use the repository's package manager and scripts when present. Prefer existing scripts in package.json; fall back only when a script is missing.

# 1. Format - required
bun run format || npm run format || npx biome check --write .

# 2. Lint - required
bun run lint || npm run lint || bunx turbo lint

# 3. Type-check - required
bun run typecheck || bun run type-check || npm run typecheck || npm run type-check || npx tsc --noEmit

# 4. Tests - run when configured
npm test || bun run test --filter=[changed-package]

# 5. Build - run when configured
npm run build

If format, lint, or type-check fails, fix it before pushing, opening a release PR, or triggering deployment. Do not hand known local quality failures to GitHub Actions.

Deployment Process

To Staging

Ensure trunk CI is green
Trigger deploy to staging environment from the trunk (no staging branch)
Wait for CI and staging health checks to pass

To Production

Ensure staging environment is healthy
Require explicit confirmation — production is critical
Deploy to production environment from the trunk
Monitor deployment
Watch health endpoints and error tracking for 15 minutes

Hotfix Flow

Branch hotfix/xxx off the trunk (default branch)
Fix -> PR to trunk -> merge -> deploy to production

Post-Deployment Verification

Check health endpoints
Monitor error tracking (Sentry, etc.)
Verify critical user flows
Check deployment logs

Rollback

If deployment fails, revert the merge commit and re-deploy.

References

See references/workflow.md for platform-specific deployment details, AWS patterns, CI/CD integration, and rollback procedures.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-deploy/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-deploy.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-deploy",
  "kind": "skill",
  "name": "deploy",
  "description": "Run deployment workflows for web applications (staging, production). Use when user says 'deploy', 'push to staging', 'release', 'ship it', or 'go live'.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "deployment",
      "devops",
      "ci-cd",
      "production",
      "staging",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Run deployment workflows for web applications (staging, production). Use when user says 'deploy', 'push to staging', 'release', 'ship it', or 'go live'."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/deploy/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/deploy/SKILL.md",
      "key": "shipshitdev/skills/skills/deploy/SKILL.md"
    }
  },
  "instructions": "# Deploy\n\n## Contract\n\nInputs:\n\n- Repository root\n- Target environment: preview, staging, or production\n- Optional branch, PR number, deployment provider, and health-check URL\n\nOutputs:\n\n- Pre-deploy gate results\n- Deployment route and provider\n- Verification status\n- Rollback or follow-up instructions when needed\n\nCreates/Modifies:\n\n- Local changes only when fixing failed gates before deployment\n- Release PRs only when delegated to `release-pr-gates`\n\nExternal Side Effects:\n\n- May trigger provider deployments\n- May create or update GitHub PRs through delegated release skills\n- May read logs a",
  "cost": {
    "context_tokens": 763
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-deploy/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.