ericrisco/rsc-harness / skills/render
render
VerifiedUse when deploying or fixing an app on Render — web services, background workers, cron jobs, private services, managed Postgres and Key-Value, and especially the render.yaml Blueprint. Covers deploys that fail with no open ports detected, 502s on first deploy, free-tier cold starts, and a free Postgres about to expire with its data. NOT the generic ship and release flow (that is `deployment`), NOT another PaaS such as `railway` or `fly-io`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.9 KB |
| evals/README.md | markdown | 834 B |
| evals/cases.yaml | config | 3.7 KB |
| references/blueprint-reference.md | markdown | 6.7 KB |
| scripts/verify.shexecutable | script | 5.5 KB |
scripts/verify.sh
View on GitHub#!/usr/bin/env bash
# verify.sh — lint every render.yaml Blueprint in a target directory against the
# correctness rules that cause real Render deploy failures. Read-only: parses YAML,
# checks rules, prints findings. No network, no Render account.
#
# Usage:
# bash scripts/verify.sh [TARGET_DIR] # default: current directory
#
# Checks per service:
# - has `name` and a valid `type` (web|pserv|worker|cron|keyvalue)
# - `runtime` present for every non-keyvalue service and is a valid enum
# - `schedule` present iff `type: cron`
# - `plan` / `region` (if set) are valid enums
# - WARN if a `web` service `startCommand` hardcodes a numeric port without $PORT
#
# Exit codes: 0 = clean OR no render.yaml found (never a false failure);
# 1 = at least one hard error. Warnings never fail the run.
#
# Portable to macOS bash 3.2 and CI bash 5. NO_COLOR=1 disables color.
set -euo pipefail
TARGET="${1:-.}"
if [ -n "${NO_COLOR:-}" ] || [ ! -t 1 ]; then
RED=""; YEL=""; GRN=""; RST=""
else
RED=$'\033[31m'; YEL=$'\033[33m'; GRN=$'\033[32m'; RST=$'\033[0m'
fi
have() { command -v "$1" >/dev/null 2>&1; }
# Discover render.yaml / render.yml files. No matches -> clean exit 0.
FILES=""
while IFS= read -r f; do
FILES="$FILES$f
"
done < <(find "$TARGET" -type f \( -name 'render.yaml' -o -name 'render.yml' \) 2>/dev/null)
if [ -z "${FILES%$'\n'}" ]; then
echo "${GRN}OK${RST} no render.yaml found under '$TARGET' — nothing to verify."
exit 0
fi
ERRORS=0
if have python3; then
while IFS= read -r FILE; do
[ -z "$FILE" ] && continue
echo "→ $FILE"
OUT="$(
RENDER_FILE="$FILE" python3 - <<'PY'
import os, sys
try:
import yaml
except Exception:
print("WARN\tPyYAML not installed; skipped deep checks (heuristics only)")
sys.exit(3)
path = os.environ["RENDER_FILE"]
try:
with open(path) as fh:
doc = yaml.safe_load(fh) or {}
except Exception as e:
print(f"ERROR\tYAML parse failed: {e}")
sys.exit(0)
VALID_TYPE = {"web", "pserv", "worker", "cron", "keyvalue"}
VALID_RUNTIME = {"node","python","docker","image","static","go","ruby","elixir","rust"}
VALID_PLAN = {"free","starter","standard","pro","pro plus","pro max","pro ultra"}
VALID_REGION = {"oregon","ohio","virginia","frankfurt","singapore"}
services = doc.get("services") or []
if not isinstance(services, list):
print("ERROR\t`services` must be a list")
services = []
for i, svc in enumerate(services):
if not isinstance(svc, dict):
print(f"ERROR\tservices[{i}] is not a mapping")
continue
label = svc.get("name") or f"services[{i}]"
stype = svc.get("type")
if not svc.get("name"):
print(f"ERROR\t{label}: missing `name`")
if stype not in VALID_TYPE:
print(f"ERROR\t{label}: invalid/missing `type` ({stype!r}); expected one of {sorted(VALID_TYPE)}")
if stype != "keyvalue":
rt = svc.get("runtime")
if not rt:
print(f"ERROR\t{label}: missing `runtime` (required for type {stype!r})")
elif rt not in VALID_RUNTIME:
print(f"ERROR\t{label}: invalid `runtime` ({rt!r})")
if stype == "cron" and not svc.get("schedule"):
print(f"ERROR\t{label}: type cron requires a `schedule:`")
if stype and stype != "cron" and svc.get("schedule"):
print(f"WARN\t{label}: `schedule:` is only used by type cron; ignored here")
plan = svc.get("plan")
if plan is not None and plan not in VALID_PLAN:
print(f"ERROR\t{label}: invalid `plan` ({plan!r})")
region = svc.get("region")
if region is not None and region not in VALID_REGION:
print(f"ERROR\t{label}: invalid `region` ({region!r})")
if stype == "web":
cmd = str(svc.get("startCommand") or "")
import re
if cmd and "$PORT" not in cmd and "${PORT}" not in cmd and re.search(r":\d{2,5}\b", cmd):
print(f"WARN\t{label}: web startCommand looks like it hardcodes a port without $PORT — Render may report 'no open ports detected'")
dbs = doc.get("databases") or []
if not isinstance(dbs, list):
print("ERROR\t`databases` must be a list")
dbs = []
for i, db in enumerate(dbs):
if isinstance(db, dict) and db.get("plan") == "free":
print(f"WARN\tdatabase {db.get('name', i)!r}: free Postgres is deleted 30 days after creation — use starter for production")
PY
)" || true
# Surface findings; count hard errors.
if [ -n "$OUT" ]; then
while IFS= read -r line; do
[ -z "$line" ] && continue
case "$line" in
ERROR*) echo " ${RED}${line}${RST}"; ERRORS=$((ERRORS + 1)) ;;
WARN*) echo " ${YEL}${line}${RST}" ;;
*) echo " $line" ;;
esac
done <<EOF
$OUT
EOF
else
echo " ${GRN}OK${RST}"
fi
done <<EOF
$FILES
EOF
else
# No python3: fall back to a shallow grep-based sanity pass (heuristic only).
echo "${YEL}WARN${RST} python3 not found — running shallow grep checks only."
while IFS= read -r FILE; do
[ -z "$FILE" ] && continue
echo "→ $FILE"
if grep -Eq '^\s*type:\s*cron' "$FILE" && ! grep -Eq '^\s*schedule:' "$FILE"; then
echo " ${RED}ERROR\ta cron service appears to be missing a schedule:${RST}"
ERRORS=$((ERRORS + 1))
fi
if grep -Eq 'startCommand:.*:[0-9]{2,5}\b' "$FILE" && ! grep -q '\$PORT' "$FILE"; then
echo " ${YEL}WARN\tstartCommand may hardcode a port without \$PORT${RST}"
fi
echo " ${GRN}OK${RST} (shallow)"
done <<EOF
$FILES
EOF
fi
echo
if [ "$ERRORS" -gt 0 ]; then
echo "${RED}FAIL${RST} $ERRORS error(s) found."
exit 1
fi
echo "${GRN}PASS${RST} render.yaml checks clean."
exit 0
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |