SKILL.md
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 --jsonExtract and return a simplified summary, not the full JSON.
List Workspaces
railway whoami --jsonReturns 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 linkAfter switching, use status skill to see project details.
Update Project
Modify project settings via GraphQL API.
Get Project ID
railway status --jsonExtract project.id from the response.
Update Mutation
bash <<'SCRIPT'
scripts/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"}}'
SCRIPTProjectUpdateInput 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:
scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name"}}'Enable PR deploys:
scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"prDeploys": true}}'Make project public:
scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"isPublic": true}}'Multiple fields:
scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name", "prDeploys": true}}'Composability
- View project details: Use
statusskill
- Create new project: Use
newskill
- Manage environments: Use
environmentskill
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.