Skip to content

ericrisco/rsc-harness / skills/coolify

coolify

Flagged

Use when self-hosting apps and databases with Coolify on a VPS you own — install, first-admin lockdown, Git-to-deploy (Nixpacks/Dockerfile/compose), managed Postgres/Redis, scheduled S3 backups, domains + auto-SSL. NOT a PaaS someone else runs (that is `railway`), NOT sizing/hardening the box (that is `hetzner`), NOT authoring Dockerfiles (that is `docker`).

FileKindSize
SKILL.mdskill md13.1 KB
evals/README.mdmarkdown1.5 KB
evals/cases.yamlconfig4.1 KB
references/databases-and-backups.mdmarkdown4.5 KB
references/deploy-recipes.mdmarkdown4.7 KB
references/install-and-proxy.mdmarkdown4.4 KB
scripts/verify.shexecutablescript5.2 KB

scripts/verify.sh

View on GitHub
#!/usr/bin/env bash
set -euo pipefail

# verify.sh — coolify skill gate. Run from your PROJECT root (or this skill's dir).
#
# Static, read-only lint of any committed docker-compose artifact (docker-compose.yml/.yaml,
# compose.yml/.yaml) plus a check that this skill's SKILL.md documents the canonical port matrix.
# It NEVER writes, NEVER connects to the network, and NEVER deploys.
#
# Per compose file it asserts:
#   (a) no hardcoded secret literal — values for *PASSWORD*/*SECRET*/*TOKEN*/*_KEY*/DATABASE_URL
#       must be env-refs (${...}) , not inline literals.
#   (b) any database service (postgres/mysql/mariadb/mongo) is backed by a NAMED volume (data-loss guard).
#   (c) at least one healthcheck: present.
#   (d) no floating ":latest" image tag, and no image without an explicit tag (also "floating").
# And once: SKILL.md mentions every canonical port (8000 80 443 6001 6002).
#
# Exit code: non-zero ONLY on a hard failure (a/b/c/d or a missing port). An EMPTY/CLEAN target
# (no compose files found) exits 0 with a skip — never a false failure. Missing optional context
# (no SKILL.md to check) is advisory, not fatal.
#
# Portability: stock macOS bash 3.2 (no mapfile, no associative arrays). Arrays are initialised so
# they expand safely under `set -u`.

YELLOW=$'\033[33m'; GREEN=$'\033[32m'; RED=$'\033[31m'; NC=$'\033[0m'
EXIT=0
skip() { printf '%s[skip]%s %s\n' "$YELLOW" "$NC" "$*"; }
warn() { printf '%s[warn]%s %s\n' "$YELLOW" "$NC" "$*"; }
ok()   { printf '%s[ok]%s %s\n'   "$GREEN"  "$NC" "$*"; }
err()  { printf '%s[fail]%s %s\n' "$RED"    "$NC" "$*"; EXIT=1; }

ROOT="$(pwd)"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"

# --- discover compose files (skip vendor dirs) ---
COMPOSE_FILES=()
while IFS= read -r -d '' f; do
  COMPOSE_FILES+=("$f")
done < <(
  find "$ROOT" \
    \( -path '*/node_modules/*' -o -path '*/.git/*' -o -path '*/vendor/*' -o -path '*/.venv/*' \) -prune -o \
    -type f \( -name 'docker-compose.yml' -o -name 'docker-compose.yaml' \
               -o -name 'compose.yml' -o -name 'compose.yaml' \) -print0 2>/dev/null
)

lint_compose() {
  file="$1"
  base="$(basename "$file")"

  # (a) hardcoded secrets: a *PASSWORD/SECRET/TOKEN/_KEY/DATABASE_URL key whose value is NOT a ${...} ref
  #     and is not empty. We look at "key: value" pairs (env blocks are key: value in compose).
  if grep -Eiq '^[[:space:]]*[A-Za-z_]*(password|secret|token|_key|database_url)[A-Za-z_]*[[:space:]]*:[[:space:]]*[^$[:space:]"'"'"'].*' "$file"; then
    # exclude the case where the value is an env-ref like ${FOO}
    if grep -Ei '^[[:space:]]*[A-Za-z_]*(password|secret|token|_key|database_url)[A-Za-z_]*[[:space:]]*:[[:space:]]*' "$file" \
       | grep -Eiv ':[[:space:]]*("?\$\{|\$[A-Za-z_])' \
       | grep -Eq ':[[:space:]]*[^[:space:]$]'; then
      err "$base: hardcoded secret literal — use an env-ref (\${VAR}) injected by Coolify, not an inline value"
    fi
  fi

  # (b) named volume for any database service. If a db image is present, require a top-level `volumes:` map.
  if grep -Eiq 'image:[[:space:]]*("?)(postgres|mysql|mariadb|mongo)' "$file"; then
    if grep -Eq '^volumes:' "$file"; then
      ok "$base: database service has a named volume declaration"
    else
      err "$base: database service without a named volume — data is wiped on recreate"
    fi
  fi

  # (c) at least one healthcheck
  if grep -Eq '^[[:space:]]*healthcheck:' "$file"; then
    ok "$base: healthcheck present"
  else
    err "$base: no healthcheck: — Coolify/Traefik can't tell when the container is ready"
  fi

  # (d) floating tags: image: foo:latest, or image: foo with no tag at all
  while IFS= read -r line; do
    img="$(printf '%s' "$line" | sed -E 's/^[[:space:]]*image:[[:space:]]*"?//; s/"?[[:space:]]*$//')"
    case "$img" in
      \$*) : ;;                                   # env-ref image, skip
      *:latest) err "$base: floating ':latest' tag on image '$img' — pin a tag or digest" ;;
      *@sha256:*) : ;;                            # digest-pinned, fine
      *:*) : ;;                                   # has an explicit tag, fine
      *) err "$base: image '$img' has no tag (floating) — pin a tag or digest" ;;
    esac
  done < <(grep -E '^[[:space:]]*image:[[:space:]]*' "$file" || true)
}

if [ "${#COMPOSE_FILES[@]}" -eq 0 ]; then
  skip "no docker-compose files found — nothing to lint (clean)"
else
  for f in "${COMPOSE_FILES[@]}"; do
    lint_compose "$f"
  done
fi

# --- port matrix documented in SKILL.md (look next to this script, then under ROOT) ---
SKILL_MD=""
if [ -f "$SCRIPT_DIR/../SKILL.md" ]; then
  SKILL_MD="$SCRIPT_DIR/../SKILL.md"
else
  cand="$(find "$ROOT" -type f -name 'SKILL.md' -path '*coolify*' -print 2>/dev/null | head -n1 || true)"
  [ -n "$cand" ] && SKILL_MD="$cand"
fi

if [ -n "$SKILL_MD" ] && [ -f "$SKILL_MD" ]; then
  missing=""
  for p in 8000 80 443 6001 6002; do
    grep -Eq "(^|[^0-9])$p([^0-9]|$)" "$SKILL_MD" || missing="$missing $p"
  done
  if [ -n "$missing" ]; then
    err "SKILL.md missing canonical port(s):$missing"
  else
    ok "SKILL.md documents the canonical port matrix (8000/80/443/6001/6002)"
  fi
else
  skip "no coolify SKILL.md found to check the port matrix"
fi

printf '\n'
if [ "$EXIT" -eq 0 ]; then ok "verify.sh passed"; else err "verify.sh found failures"; fi
exit "$EXIT"
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall