How do I install the Infra skill?

Run npx skillmds@latest add persimmon-automation-labs/infra in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Infra skill do?

Infra — Index It is listed under DevOps & Infra on SkillMD.

Is Infra safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Infra?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Infra free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Persimmon-Automation-Labs (@persimmon-automation-labs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Infra by persimmon-automation-labs — Agent Skill

Name: Infra
Rating: 4.2 (5 reviews)
Author: Persimmon-Automation-Labs

File contents

Infra — Index

Persimmon infra = Railway (app + DB + bucket in one project), S3-compatible storage with presigned uploads, resumable background jobs, and a minimal GitHub Actions CI. This mother is a map; follow the child for the actual work.

Trigger

"Deploy this" / "custom domain" / "env vars"
"File upload" / "presigned URL" / "bucket CORS"
"Background job" / "long-running task" / "queue / cron"
"Set up CI"

The child skills

Skill	When to use	Owns
`infra-railway-deploy`	Project creation, deploy, domains	Railway project setup, env vars, custom domain, container port (8080), staged-config drift recovery
`infra-s3-uploads`	Any file upload flow	Presigned PUT flow, bucket CORS, multipart, content-type validation (Tigris/R2/S3)
`infra-background-jobs`	Work that can't finish in a request	Idempotent resumable pipelines on Railway (pg-boss / Inngest / cron)
`infra-github-ci`	CI pipeline	Minimal Next.js CI — lint, typecheck, `prisma validate`, build

How to route

Deploying / hosting? → infra-railway-deploy.
Uploads? → infra-s3-uploads (presigned PUT — never proxy bytes through Next).
Long job? → infra-background-jobs (idempotent + resumable).
CI? → infra-github-ci.

Persimmon infra defaults — one-screen summary

Railway container port is 8080 (from PORT). Public domain targetPort must match — not 3000.
Uploads: server issues presigned URL → client PUTs directly to the bucket.
Bucket CORS must include every uploading origin (http://localhost:3000, preview URLs, prod domains) via PutBucketCorsCommand, or uploads fail silently with net::ERR_FAILED.
Railway managed bucket stays staged until the dashboard "Deploy" is committed once.
Staged-config drift: committing an older draft reverts live mutations; Settings → Source → Disconnect → Reconnect drains the draft.
CD: Railway auto-deploys on push to main. CI: lint, typecheck, prisma validate, build.

Anti-patterns banned

Public domain targetPort mismatched with 8080
Proxying upload bytes through Next instead of presigned PUT
Missing CORS origins on the bucket
Non-idempotent background jobs that can't resume
Committing secrets — use Railway/GitHub env, never code

Relationship to other mothers

Mother	Connection
`stack`	Deployed app code follows `stack` conventions
`data`	Railway hosts Postgres + pgvector
`security`	`infra-github-ci` runs the checks `security-review` relies on

---name: infradescription: Infra — Index---# Infra — IndexPersimmon infra = Railway (app + DB + bucket in one project), S3-compatible storage with presigned uploads, resumable background jobs, and a minimal GitHub Actions CI. This mother is a map; follow the child for the actual work.## Trigger- "Deploy this" / "custom domain" / "env vars"- "File upload" / "presigned URL" / "bucket CORS"- "Background job" / "long-running task" / "queue / cron"- "Set up CI"## The child skills| Skill | When to use | Owns ||---|---|---|| `infra-railway-deploy` | Project creation, deploy, domains | Railway project setup, env vars, custom domain, container port (8080), staged-config drift recovery || `infra-s3-uploads` | Any file upload flow | Presigned PUT flow, bucket CORS, multipart, content-type validation (Tigris/R2/S3) || `infra-background-jobs` | Work that can't finish in a request | Idempotent resumable pipelines on Railway (pg-boss / Inngest / cron) || `infra-github-ci` | CI pipeline | Minimal Next.js CI — lint, typecheck, `prisma validate`, build |## How to route1. **Deploying / hosting?** → `infra-railway-deploy`.2. **Uploads?** → `infra-s3-uploads` (presigned PUT — never proxy bytes through Next).3. **Long job?** → `infra-background-jobs` (idempotent + resumable).4. **CI?** → `infra-github-ci`.## Persimmon infra defaults — one-screen summary- **Railway container port is `8080`** (from `PORT`). Public domain `targetPort` must match — not 3000.- **Uploads**: server issues presigned URL → client PUTs directly to the bucket.- **Bucket CORS** must include every uploading origin (`http://localhost:3000`, preview URLs, prod domains) via `PutBucketCorsCommand`, or uploads fail silently with `net::ERR_FAILED`.- **Railway managed bucket** stays staged until the dashboard "Deploy" is committed once.- **Staged-config drift**: committing an older draft reverts live mutations; Settings → Source → Disconnect → Reconnect drains the draft.- **CD**: Railway auto-deploys on push to `main`. **CI**: lint, typecheck, `prisma validate`, build.## Anti-patterns banned- Public domain `targetPort` mismatched with `8080`- Proxying upload bytes through Next instead of presigned PUT- Missing CORS origins on the bucket- Non-idempotent background jobs that can't resume- Committing secrets — use Railway/GitHub env, never code## Relationship to other mothers| Mother | Connection ||---|---|| `stack` | Deployed app code follows `stack` conventions || `data` | Railway hosts Postgres + pgvector || `security` | `infra-github-ci` runs the checks `security-review` relies on |

Frequently asked questions

Infra