Skip to main content

Claude Skills for Gravity Rail

Gravity Rail publishes a free plugin for Claude Code and Claude Cowork that gives Claude built-in knowledge of the Gravity Rail SDK and CLI. Once installed, Claude can help you write integrations, explore the API, and troubleshoot issues without leaving your editor or workspace.

What you get​

The gravity-rail-developer plugin includes two skills:

SkillWhat Claude learns
SDK GuideAuthentication, method conventions, types, Zod schemas, scopes, error handling, and common integration patterns for @gravity-rail/sdk
CLI GuideInstallation, command patterns, domain listing, CRUD recipes, output formats, and scripting tips for @gravity-rail/cli

Skills activate automatically when Claude detects you're working with Gravity Rail — no slash commands required.

Install in Claude Code​

1. Add the marketplace​

Open Claude Code and run:

/plugin marketplace add Gravity-Rail/claude-plugins

This registers the Gravity Rail marketplace so you can browse its plugins.

2. Install the plugin​

/plugin install gravity-rail-developer@gravity-rail-public-marketplace

Choose an installation scope when prompted:

  • User — available in all your projects (recommended)
  • Project — shared with everyone on this repository
  • Local — just you, just this repo

3. Verify​

Run /plugin and check the Installed tab. You should see gravity-rail-developer listed.

Usage​

Once installed, the skills are always available. Just ask Claude:

How do I create a member with the Gravity Rail SDK?
Show me how to list all chats using the CLI
What scopes do I need to read data records?

Claude will use its knowledge of the SDK and CLI to give you accurate, up-to-date answers with working code examples.

Keeping up to date​

To pull the latest skill updates:

/plugin marketplace update gravity-rail-public-marketplace

Install in Claude Cowork​

Claude Cowork is Anthropic's browser-based workspace for getting professional work done with Claude. It supports the same plugin system as Claude Code.

1. Open the plugin manager​

In a Cowork session, type:

/plugin marketplace add Gravity-Rail/claude-plugins

2. Install the plugin​

/plugin install gravity-rail-developer@gravity-rail-public-marketplace

3. Start using it​

Ask Claude anything about Gravity Rail's SDK or CLI. The skills activate automatically based on context.

What the skills cover​

SDK Guide​

  • Authentication — API keys, OAuth 2.0 with PKCE, member identity switching
  • Method conventions — get*, create*, update*, delete* naming patterns
  • Domain overview — members, chats, tasks, workflows, data types, agents, and more
  • Type system — importing types and using Zod schemas for runtime validation
  • Scopes and permissions — which scopes protect which endpoints
  • Error handling — working with ApiError and HTTP status codes
  • Integration patterns — webhooks, polling, white-label provisioning

CLI Guide​

  • Installation — npm install -g @gravity-rail/cli or run via npx
  • Authentication — OAuth login and API key usage
  • Command patterns — gr <domain> <action> [options]
  • Output formats — table (default), JSON (-o json), piping to jq
  • Domain listing — all available domains grouped by category
  • CRUD recipes — list, get, create, update, delete patterns
  • Scripting — chaining commands, extracting IDs, bulk operations

Requirements​

  • Claude Code version 1.0.33 or later
  • Claude Cowork — any paid Claude plan
  • No Gravity Rail account is needed to install the plugin — the skills provide general guidance. To make API calls, you'll need an API key or MCP connection.

Source code​

The plugin source is open at github.com/Gravity-Rail/claude-plugins. Contributions and feedback are welcome.