si-coder-agent — Umbrella

This is the parent skill for the SI Coder family. After installing (see install.sh), the following slash commands are available:

Implemented (7):

Two deploy paths (same flow shape)

• (A) Self-hosted — GitHub → Dokploy app + self-hosted Convex compose → Hostinger A-record → verify. /sc-all --target dokploy
• (B) Online — GitHub → Vercel frontend + Convex Cloud backend → Hostinger CNAME/A to Vercel → verify. /sc-all --target vercel

flowchart TD
    O["/sc-all"] --> G["/sc-git<br/>repo create + push"]
    G --> T{"--target?"}
    T -->|dokploy| H1["/sc-dokploy<br/>project · app · compose · domains"]
    H1 --> C1["/sc-convex<br/>self-hosted backend + admin key + JWT"]
    C1 --> D1["Hostinger A → VPS"]
    T -->|vercel| H2["/sc-convex-cloud<br/>managed backend (coupled build)"]
    H2 --> C2["/sc-vercel<br/>GitHub-bound project + domain"]
    C2 --> D2["Hostinger CNAME / A → Vercel"]
    D1 --> V["verify live URL"]
    D2 --> V

Stubs (5, exit code 2 until implemented): /sc-cf (Cloudflare), /sc-stripe (payments), /sc-resend (email), /sc-clerk (auth alt), /sc-supabase (backend alt).

The legacy `/use-si-coder` continues to work in parallel — it runs the monolithic scripts/deploy.js which still bundles GitHub + Dokploy + Convex + Hostinger DNS.

Why modular?

• Surgical ops — change a Convex admin key without re-deploying the world
• Discoverable — /sc-dokploy makes Dokploy CRUD a first-class skill, not buried inside deploy.js
• Composable — /sc-all is the only consumer that pulls everything together
• Onboarding-aware — /sc-onboarding knows which /sc-* you ticked and asks for only what's missing

CORE MANDATES (shared)

These apply across every sub-skill:

1. Self-Hosted Convex by default: never silently swap to Clerk. Use @convex-dev/auth.
2. `convex/_generated` is committed: don't run codegen inside Dockerfile.
3. `npm install --yes --legacy-peer-deps` — no interactive prompts.
4. Idempotency: duplicate domain creation = no-op, not error.
5. Admin key sync rule: Dokploy compose env + repo env file always match.
6. Preserve your Dokploy control host (the one in DOKPLOY_API_URL) — never rewrite it inside scripts.
7. Clerk MCP for Clerk apps: if target uses Clerk, preserve it; use Clerk MCP (clerk at https://mcp.clerk.com/mcp).
8. Exact cloning: if user wants a clone of an existing site, fetch and replicate layout, not a generic dashboard.

Repo layout

si-coder-agent/
├── SKILL.md           ← this file
├── README.md
├── .env.example
├── install.sh         ← symlinks skills/* (sc-*, use-si-coder, stubs) into ~/.claude/skills/
├── lib/               ← shared modules
│   ├── dokploy.js     ← Dokploy REST
│   ├── github.js      ← GitHub REST + repo CRUD
│   ├── hostinger.js   ← Hostinger DNS (A/CNAME)
│   ├── convex.js      ← Convex self-hosted (Dokploy compose)
│   ├── convex-cloud.js← Convex Cloud (managed) deploy
│   ├── vercel.js      ← Vercel projects/domains/deploys
│   ├── proc.js        ← no-shell execFileSync process runner
│   ├── tls.js         ← TLS verification helpers (always on)
│   └── env.js         ← env scan + ~/.bashrc merge writer
├── skills/
│   ├── sc-all/SKILL.md
│   ├── sc-dokploy/{SKILL.md, scripts/}
│   ├── sc-convex/{SKILL.md, scripts/}
│   ├── sc-convex-cloud/{SKILL.md, scripts/}
│   ├── sc-vercel/{SKILL.md, scripts/}
│   ├── sc-git/{SKILL.md, scripts/}
│   └── sc-onboarding/{SKILL.md, scripts/, steps/}
├── scripts/
│   └── deploy.js      ← legacy monolith, still functional
└── bin/
    └── onboard.js     ← one-shot CLI wizard (no AI needed)

Security posture (hardened 2026-06-14)

All sc-* skills: no-shell execFileSync (no command injection), TLS verification always on, no secrets in logs / build-args / git-URLs, ~/.bashrc writes single-quote escaped. Requires Node >=18 (native fetch), no runtime deps, CommonJS. Legacy one-shot scripts/deploy.js remains available.

Deployment profile (placeholders only)

# GitHub
GITHUB_TOKEN=ghp_<your_token>

# Dokploy
DOKPLOY_API_URL=https://<your-dokploy-host>/api
DOKPLOY_API_KEY=<your_dokploy_api_key>

# Hostinger DNS (optional)
HOSTINGER_API_TOKEN=<your_hostinger_token>

# Clerk (only for explicitly-Clerk apps)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_live_<clerk_publishable_key>
CLERK_SECRET_KEY=sk_live_<clerk_secret_key>
NEXT_PUBLIC_CLERK_FRONTEND_API_URL=https://<clerk-issuer-domain>

# Convex self-hosted (filled in by deploy)
CONVEX_SELF_HOSTED_URL=https://<convex-api-domain>
CONVEX_SELF_HOSTED_ADMIN_KEY=<convex_admin_key>
NEXT_PUBLIC_CONVEX_URL=https://<convex-api-domain>
NEXT_PUBLIC_CONVEX_SITE_URL=https://<convex-site-domain>

Never store real keys or live hostnames inside skill examples or agent instructions — always placeholders.