Skip to content
Skillv1.0.0

railway-projects

List, switch, and configure Railway projects. Use when user wants to list all projects, switch projects, rename a project, enable/disable PR deploys, make a project public/private, or modify project s

by davila7(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from davila7/claude-code-templates (cli-tool/components/skills/railway/projects/SKILL.md). Install upstream with npx skills add davila7/claude-code-templates --skill projects. Copyright stays with the author (MIT).

Railway Project Management

List, switch, and configure Railway projects.

When to Use

  • User asks "show me all my projects" or "what projects do I have"
  • User asks about projects across workspaces
  • User asks "what workspaces do I have"
  • User wants to switch to a different project
  • User asks to rename a project
  • User wants to enable/disable PR deploys
  • User wants to make a project public or private
  • User asks about project settings

List Projects

The railway list --json output can be very large. Run in a subagent and return only essential fields:

  • Project: id, name
  • Workspace: id, name
  • Services: name (optional, if user needs service context)
railway list --json

Extract and return a simplified summary, not the full JSON.

List Workspaces

railway whoami --json

Returns user info including all workspaces the user belongs to.

Switch Project

Link a different project to the current directory:

railway link -p <project-id-or-name>

Or interactively:

railway link

After switching, use railway-status skill to see project details.

Update Project

Modify project settings via GraphQL API.

Get Project ID

railway status --json

Extract project.id from the response.

Update Mutation

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation updateProject($id: String!, $input: ProjectUpdateInput!) {
    projectUpdate(id: $id, input: $input) { name prDeploys isPublic botPrEnvironments }
  }' \
  '{"id": "PROJECT_ID", "input": {"name": "new-name"}}'
SCRIPT

ProjectUpdateInput Fields

Field Type Description
name String Project name
description String Project description
isPublic Boolean Make project public/private
prDeploys Boolean Enable/disable PR deploys
botPrEnvironments Boolean Enable Dependabot/Renovate PR environments

Examples

Rename project:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name"}}'

Enable PR deploys:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"prDeploys": true}}'

Make project public:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"isPublic": true}}'

Multiple fields:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name", "prDeploys": true}}'

Composability

  • View project details: Use railway-status skill
  • Create new project: Use railway-new skill
  • Manage environments: Use railway-environment skill

Error Handling

Not Authenticated

Not authenticated. Run `railway login` first.

No Projects

No projects found. Create one with `railway init`.

Permission Denied

You don't have permission to modify this project. Check your Railway role.

Project Not Found

Project "foo" not found. Run `railway list` to see available projects.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/davila7-claude-code-templates-projects/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

davila7-claude-code-templates-projects.ocm.jsonjson
{
  "ocm": "1",
  "id": "davila7-claude-code-templates-projects",
  "kind": "skill",
  "name": "railway-projects",
  "description": "List, switch, and configure Railway projects. Use when user wants to list all projects, switch projects, rename a project, enable/disable PR deploys, make a project public/private, or modify project settings.",
  "publisher": "davila7",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "railway",
      "projects",
      "workspace",
      "management",
      "settings",
      "infrastructure",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "List, switch, and configure Railway projects. Use when user wants to list all projects, switch projects, rename a project, enable/disable PR deploys, make a project public/private, or modify project settings."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/davila7/claude-code-templates",
      "path": "cli-tool/components/skills/railway/projects/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/davila7/claude-code-templates/blob/HEAD/cli-tool/components/skills/railway/projects/SKILL.md",
      "key": "davila7/claude-code-templates/cli-tool/components/skills/railway/projects/SKILL.md"
    },
    "allowed_tools": [
      "Bash(railway:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Railway Project Management\n\nList, switch, and configure Railway projects.\n\n## When to Use\n\n- User asks \"show me all my projects\" or \"what projects do I have\"\n- User asks about projects across workspaces\n- User asks \"what workspaces do I have\"\n- User wants to switch to a different project\n- User asks to rename a project\n- User wants to enable/disable PR deploys\n- User wants to make a project public or private\n- User asks about project settings\n\n## List Projects\n\nThe `railway list --json` output can be very large. Run in a subagent and return only essential fields:\n\n- Project: `id`, `name`\n- W",
  "cost": {
    "context_tokens": 786
  }
}

Fetch it by URL: GET /api/v1/registry/davila7-claude-code-templates-projects/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.