railwayapp/railway-skills

Railway Skills – 개요

Railway Skills는 대규모 언어 모델(LLM) 에이전트가 Railway(앱을 배포하고 관리하기 위한 클라우드 플랫폼)와 통신할 수 있게 하는 에이전트 스킬 모음입니다. 이 저장소는 오픈소스 Agent Skills 형식을 따르며 인기 있는 LLM 기반 환경을 위한 기성 플러그인을 번들로 제공합니다:

ChatGPT / OpenAI Codex
Claude (및 Claude Code)
Cursor
Grok Build (xAI)
Google Antigravity

각 플러그인은 동일한 핵심 스킬인 use-railway와 LLM이 Railway의 API를 안전하게 호출할 수 있게 하는 작은 "MCP"(메시지 제어 프로토콜) 서버 구성을 패키징합니다(OAuth/OIDC). 플러그인은 각 마켓플레이스에 게시되며, 저장소는 GitHub에서 정확한 버전을 직접 설치할 수 있도록 원본 매니페스트도 제공합니다.

시작하기

Railway CLI를 설치하고 에이전트 지원을 활성화합니다

curl -fsSL agents.railway.com | sh   # CLI 및 에이전트 구성 요소 설치
railway login                       # 아직 로그인하지 않은 경우

이미 CLI가 있다면 railway setup agent를 실행하기만 하면 됩니다.

LLM 환경을 선택하고 README의 짧은 지침을 따릅니다:
- ChatGPT / Codex – ChatGPT 플러그인 디렉토리에서 공식 Railway 플러그인을 추가하거나 이 저장소를 마켓플레이스 소스로 추가합니다.
- Claude / Claude Code – Claude 커넥터 또는 표시된 Anthropic 마켓플레이스 명령을 통해 설치합니다.
- Cursor – Cursor 마켓플레이스에서 플러그인을 추가하거나 Cursor의 플러그인 설정에 저장소 URL을 붙여넣습니다.
- Grok Build – Grok TUI 내의 xAI 마켓플레이스에서 설치합니다.
- Google Antigravity – Antigravity 내의 사용자 정의 URL에서 설치합니다.
플러그인이 프롬프트를 표시하면 인증합니다. Railway 계정이 LLM에 연결되어 에이전트가 서비스 생성, 명령 실행, 로그 읽기 등을 할 수 있습니다.

스킬이 실제로 하는 일

이 저장소는 설치 가능한 단일 스킬을 제공합니다:

use-railway – plugins/railway/skills/use-railway/SKILL.md에 정의되어 있습니다.

이 스킬은 라우트 우선 방식입니다. LLM은 먼저 사용자의 의도(예: "내 Node 앱 배포" 또는 "서비스 X의 로그 표시")를 SKILL.md의 사전 정의된 라우트와 일치시킵니다. 라우트가 선택되면 스킬은 요청된 작업을 수행하는 일련의 저수준 작업(Railway 백엔드에 대한 API 호출)을 실행합니다.

라우팅 로직이 마크다운 파일에 있기 때문에 개발자는 코드를 작성하지 않고도 스킬을 확장하거나 사용자 정의할 수 있습니다 – 새 의도 패턴을 추가하고 기존 또는 새 Railway API 작업에 매핑하기만 하면 됩니다.

누가 사용할 수 있나요?

LLM 기반 개발 어시스턴트 – 즉석에서 Railway 프로젝트를 생성하거나 관리해야 하는 경우.
사용자 정의 AI 에이전트를 구축하는 팀 (예: 환경을 프로비저닝하거나, 로그를 가져오거나, 배포를 트리거할 수 있는 내부 봇).
도구 제작자 – 주요 LLM 플랫폼을 위한 기성 Railway 커넥터를 원하는 경우.

라이선스

MIT – 스킬 정의와 플러그인 매니페스트를 자유롭게 재사용, 수정, 재배포할 수 있습니다.