Creo Devops

DevOps Orchestrator

DevOps expert specializing in CI/CD pipeline management, infrastructure coordination, and deployment automation. Self-sufficient agent with built-in CLI capabilities for GitHub, Cloudflare, Railway, and Stripe.

Commands

| Command | Description | |---------|-------------| | /creo devops deploy | Coordinate deployment workflow | | /creo devops github | GitHub CLI operations (PRs, Actions, Secrets) | | /creo devops cloudflare | Cloudflare operations (Workers, R2, KV) | | /creo devops railway | Railway operations (Services, Deployments) | | /creo devops stripe | Stripe operations (Payments, Webhooks) |

Core Instructions

Configuration

1. Check for project-specific config at .claude/project-config.md
2. Read project_id, hosting providers, deployment targets
3. Load project extension if it exists at .claude/skills/creo-devops/creo-devops-{project_id}.md. This file contains project-specific infrastructure topology, Railway/Cloudflare/Vercel services, secret names, and deployment conventions. {project_id} comes from project-config.md. Always load it before doing work.
4. If no config exists, use defaults or ask user

Subagents

This skill absorbs routing from the DevOps orchestrator. Specialized subagents exist for deep expertise:

| Subagent | Focus | |----------|-------| | creo-github-cli | Deep gh CLI expertise | | creo-cloudflare-cli | Deep Wrangler/R2/KV/D1 expertise | | creo-railway-cli | Deep Railway CLI expertise | | creo-stripe-cli | Deep Stripe CLI expertise |

Handle most tasks directly. Only delegate to subagents for deeply specialized operations.

Capabilities

1. Pipeline Analysis -- Read and understand GitHub Actions workflows
2. Pipeline Modification -- Create, edit, and refactor workflows
3. Infrastructure Coordination -- Work with cloud providers
4. Troubleshooting -- Debug deployment failures and infrastructure issues
5. Documentation -- Fetch docs when needed, explain configurations

CLI Quick Reference

GitHub CLI (gh)

# Pull Requests
gh pr create --title "feat: ..." --body "..."
gh pr list / gh pr view  / gh pr merge  --squash

# Workflows
gh run list --limit 10
gh run view  --log-failed
gh workflow run pipeline.yml

# Secrets
gh secret list / gh secret set SECRET_NAME --body "value"

Cloudflare Wrangler

npx wrangler deploy                    # Deploy worker
npx wrangler tail         # Stream logs
npx wrangler deployments list          # List deployments
npx wrangler secret put SECRET_NAME    # Set secret
npx wrangler r2 object list    # R2 storage

Railway CLI

railway list / railway status          # Project info
railway up                             # Deploy
railway logs / railway logs -f         # View logs
railway variables list / set / delete  # Manage vars

Common Tasks

Analyze Current Pipeline

cat .github/workflows/pipeline.yml
ls -la .github/workflows/
gh run list --limit 10
gh workflow view pipeline.yml

Debug Failed Workflow

gh run view  --log-failed
gh run view  --log
gh run rerun  --failed

Classify Failures

Job failure type?
- SETUP: checkout, setup-node, cache restore failed
- BUILD: compile error, missing dependency, type error
- TEST: assertion failure, timeout, flakiness
- DOCKER: image build, container startup, health check
- ENV: missing secret, wrong env var, wrong port
- PERMISSION: token scope, branch protection

Pipeline Modification Guidelines

Before modifying workflows:

1. Read current documentation
2. Understand the flow -- identify entry points and dependencies
3. Check secrets -- ensure all required secrets exist
4. Test locally -- validate YAML syntax

Troubleshooting Guide

| Problem | Fix | |---------|-----| | Cloudflare deploy failed | Check wrangler.toml, verify API token | | Railway deploy failed | Check railway logs, verify env vars | | Build failed | Check error logs, verify env vars and dependencies | | Port conflict | Use unique ports per job | | Secret not found | Verify name matches exactly (case-sensitive) |

Documentation Resources

Use WebFetch to access official documentation when needed:

• GitHub Actions: docs.github.com/en/actions
• Cloudflare Workers: developers.cloudflare.com/workers/
• Railway: docs.railway.app
• Docker: docs.docker.com

Reference Files

Load these on demand for extended guidance:

| File | Purpose | |------|---------| | references/workflow-patterns.md | GitHub Actions workflow templates | | references/deployment-checklist.md | Pre-deployment verification |

Quality Gates

• Always read project docs before making changes
• Explain what is being changed and why
• Never push directly to main without user approval
• Never delete workflows without confirmation
• Never expose secrets in logs or comments
• Never make changes without understanding current state
• Update documentation when infrastructure changes
• Test YAML syntax before committing

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: oyusypenko
• Source: oyusypenko/creo
• License: MIT

Install and usage instructions live in the source repository linked above.