{"id":"65817dfe-c76f-45d9-9987-b4c061874385","shortId":"xZNGKY","kind":"skill","title":"railway-tools","tagline":"Flow-specific supplemental patterns for Railway. Auto-activate for railway.toml, railway.json, Procfile. Expert knowledge for Railway deployment platform. Use when deploying applications, configuring services, managing databases, or troubleshooting Railway deployments. Not for He","description":"# Railway Deployment (Flow Tools)\n\n<workflow>\n\n## 🚀 Official Railway Skills (Highly Recommended)\n\nFor full project management, deployment automation, and service orchestration, we highly recommend installing the official Railway agent skills:\n\n- **use-railway**: Master skill for setting up projects, services, and handling deployments.\n\n**Installation:**\n\n```bash\nnpx skills add railwayapp/railway-skills\n```\n\n## Supplemental Patterns\n\nThe patterns below provide additional context for Flow-specific multi-service architectures and serverless constraints.\n\n### Serverless / App Sleeping\n\nRailway's serverless feature puts services to sleep after 10 minutes of no **outbound** traffic.\n\n**When to disable serverless (`sleepApplication: false`):**\n\n- Background workers (Celery, SAQ, RQ, Sidekiq)\n- Queue processors\n- Cron services\n- Any service without an HTTP endpoint\n\n### Multi-Service Architecture (Web + Worker)\n\nFor applications with background task processing, use distinct configuration files (e.g., `railway.app.json` and `railway.worker.json`) to manage different runtime requirements.\n\n</workflow>\n\n<guardrails>\n## Guardrails\n\n- **Disable Serverless for Workers:** Always set `sleepApplication: false` for background worker services.\n- **Use Variable References:** Prefer `${{Service.VARIABLE}}` syntax (e.g., `${{Postgres.DATABASE_URL}}`) instead of hardcoding values.\n- **Dynamic Port Binding:** Never hardcode the port. Always reference `${{PORT}}` for application port injection.\n</guardrails>\n\n<validation>\n## Validation\n\n- **Verify `sleepApplication: false` for Workers:** Ensure any background worker has `sleepApplication` explicitly set to `false`.\n- **Check PORT Dynamic Reference:** Confirm that start commands and environment variables reference `${{PORT}}`.\n</validation>\n\n<example>\n## Multi-Service Worker Example\n\n**Configuration (`railway.worker.json`):**\n\n```json\n{\n  \"service\": {\n    \"name\": \"worker\",\n    \"sleepApplication\": false\n  },\n  \"deploy\": {\n    \"startCommand\": \"python -m saq my_app.tasks.worker --workers 4\"\n  }\n}\n```\n\n</example>","tags":["railway","tools","flow","cofin","agent-skills","ai-agents","beads","claude-code","codex","cursor","developer-tools","gemini-cli"],"capabilities":["skill","source-cofin","skill-railway-tools","topic-agent-skills","topic-ai-agents","topic-beads","topic-claude-code","topic-codex","topic-cursor","topic-developer-tools","topic-gemini-cli","topic-opencode","topic-plugin","topic-slash-commands","topic-spec-driven-development"],"categories":["flow"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/cofin/flow/railway-tools","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add cofin/flow","source_repo":"https://github.com/cofin/flow","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 11 github stars · SKILL.md body (2,070 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T07:03:19.510Z","embedding":null,"createdAt":"2026-04-23T13:04:01.105Z","updatedAt":"2026-04-24T07:03:19.510Z","lastSeenAt":"2026-04-24T07:03:19.510Z","tsv":"'10':116 '4':258 'activ':13 'add':83 'addit':91 'agent':64 'alway':174,202 'app':105 'applic':27,151,206 'architectur':100,147 'auto':12 'auto-activ':11 'autom':53 'background':128,153,179,217 'bash':80 'bind':197 'celeri':130 'check':225 'command':232 'configur':28,158,243 'confirm':229 'constraint':103 'context':92 'cron':136 'databas':31 'deploy':22,26,35,40,52,78,251 'differ':166 'disabl':124,170 'distinct':157 'dynam':195,227 'e.g':160,188 'endpoint':143 'ensur':215 'environ':234 'exampl':242 'expert':18 'explicit':221 'fals':127,177,212,224,250 'featur':110 'file':159 'flow':5,41,95 'flow-specif':4,94 'full':49 'guardrail':169 'handl':77 'hardcod':193,199 'high':46,58 'http':142 'inject':208 'instal':60,79 'instead':191 'json':245 'knowledg':19 'm':254 'manag':30,51,165 'master':69 'minut':117 'multi':98,145,239 'multi-servic':97,144,238 'my_app.tasks.worker':256 'name':247 'never':198 'npx':81 'offici':43,62 'orchestr':56 'outbound':120 'pattern':8,86,88 'platform':23 'port':196,201,204,207,226,237 'postgres.database':189 'prefer':185 'process':155 'processor':135 'procfil':17 'project':50,74 'provid':90 'put':111 'python':253 'queue':134 'railway':2,10,21,34,39,44,63,68,107 'railway-tool':1 'railway.app.json':161 'railway.json':16 'railway.toml':15 'railway.worker.json':163,244 'railwayapp/railway-skills':84 'recommend':47,59 'refer':184,203,228,236 'requir':168 'rq':132 'runtim':167 'saq':131,255 'serverless':102,104,109,125,171 'servic':29,55,75,99,112,137,139,146,181,240,246 'service.variable':186 'set':72,175,222 'sidekiq':133 'skill':45,65,70,82 'skill-railway-tools' 'sleep':106,114 'sleepappl':126,176,211,220,249 'source-cofin' 'specif':6,96 'start':231 'startcommand':252 'supplement':7,85 'syntax':187 'task':154 'tool':3,42 'topic-agent-skills' 'topic-ai-agents' 'topic-beads' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-gemini-cli' 'topic-opencode' 'topic-plugin' 'topic-slash-commands' 'topic-spec-driven-development' 'traffic':121 'troubleshoot':33 'url':190 'use':24,67,156,182 'use-railway':66 'valid':209 'valu':194 'variabl':183,235 'verifi':210 'web':148 'without':140 'worker':129,149,173,180,214,218,241,248,257","prices":[{"id":"dca1be17-a39d-49a3-948d-14bca52ad1e5","listingId":"65817dfe-c76f-45d9-9987-b4c061874385","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"cofin","category":"flow","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:01.105Z"}],"sources":[{"listingId":"65817dfe-c76f-45d9-9987-b4c061874385","source":"github","sourceId":"cofin/flow/railway-tools","sourceUrl":"https://github.com/cofin/flow/tree/main/skills/railway-tools","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:01.105Z","lastSeenAt":"2026-04-24T07:03:19.510Z"}],"details":{"listingId":"65817dfe-c76f-45d9-9987-b4c061874385","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"cofin","slug":"railway-tools","github":{"repo":"cofin/flow","stars":11,"topics":["agent-skills","ai-agents","beads","claude-code","codex","context-driven-development","cursor","developer-tools","gemini-cli","opencode","plugin","slash-commands","spec-driven-development","subagents","tdd","workflow"],"license":"apache-2.0","html_url":"https://github.com/cofin/flow","pushed_at":"2026-04-19T23:22:27Z","description":"Context-Driven Development toolkit for AI agents — spec-first planning, TDD workflow, and Beads integration.","skill_md_sha":"22cce7866b9484635463e9805ee185578a2bf0dc","skill_md_path":"skills/railway-tools/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/cofin/flow/tree/main/skills/railway-tools"},"layout":"multi","source":"github","category":"flow","frontmatter":{"name":"railway-tools","description":"Flow-specific supplemental patterns for Railway. Auto-activate for railway.toml, railway.json, Procfile. Expert knowledge for Railway deployment platform. Use when deploying applications, configuring services, managing databases, or troubleshooting Railway deployments. Not for Heroku, Fly.io, or self-hosted deployments."},"skills_sh_url":"https://skills.sh/cofin/flow/railway-tools"},"updatedAt":"2026-04-24T07:03:19.510Z"}}