projects_skill

Overview

This skill manages Railway projects: listing projects and workspaces, switching or linking a project to the current directory, renaming projects, toggling PR deploys, and changing public/private visibility. Use it to inspect and modify project settings safely via the Railway CLI and GraphQL API.

How this skill works

The skill runs concise Railway CLI commands (railway list --json, railway whoami --json, railway link, railway status --json) to collect essential project and workspace fields. For updates it calls the Railway GraphQL API via a helper script (scripts/railway-api.sh) using the projectUpdate mutation and ProjectUpdateInput fields like name, prDeploys, and isPublic. It returns simplified summaries and actionable commands rather than full JSON dumps.

When to use it

• When you want a concise list of projects or workspaces you belong to
• When you need to switch or link a different project to the current directory
• When renaming a project or updating description and visibility
• When enabling or disabling PR deploys or bot PR environments
• When checking project settings before running status or environment commands

Best practices

• Run railway list --json in a subagent and return only id and name fields to avoid huge JSON payloads
• Get the current project id with railway status --json before making updates
• Use scripts/railway-api.sh with the projectUpdate mutation to change settings atomically
• Confirm authentication (railway login) before any CLI/API operation
• After switching projects, run the status skill to verify the linked project and services

Example use cases

• Show all projects across workspaces and return a short list of project id and name
• Link the repository to a different project with railway link -p <project-id-or-name>
• Rename a project using scripts/railway-api.sh with mutation and {"name": "new-name"}
• Enable PR deploys by setting prDeploys:true in the ProjectUpdateInput mutation
• Make a project public or private by setting isPublic:true/false via the update mutation