Agent skills
Published
Updated
🤖 🤖
Let your AI agent figure the details.
The fortrabbit agent skill teaches a coding agent such as Claude Code or Codex how fortrabbit works. The agent then finds the environment of the current repo, deploys, syncs the database and files, and runs remote commands over SSH.
The skill works with Claude Code, OpenAI Codex and GitHub Copilot, and with other agents that read the open Agent Skills format.
- github.com/fortrabbit/agent-skills - source code
The skill is recommended but not required. An agent can work with fortrabbit through the CLI or the MCP server alone. The skill tells it which of the two to use for a task, and covers what neither does: SSH, database and file sync.
Use cases
- An agent should deploy, sync a database, or run remote commands
- The agent keeps guessing at platform conventions
- A project should go from a local folder to a live app in one session
Install
With the frbit CLI
The frbit CLI installs the skill and connects the MCP server in one step:
frbit setup agent
For the skill alone:
frbit skills install # user scope, for the agents found on this machine
frbit skills install --project # into the current project, for all three agents
frbit skills install --agent copilot # one agent: claude-code, codex or copilot
With the GitHub CLI or npx
Requires GitHub CLI v2.90.0 or later:
gh skill install fortrabbit/agent-skills fortrabbit --agent claude-code --scope user
npx skills add fortrabbit/agent-skills
With Laravel Boost
In a Laravel app with Laravel Boost, the fortrabbit/laravel-boost package ships the skill:
composer require --dev fortrabbit/laravel-boost
php artisan boost:install
Select the package when Boost asks for third-party packages. Details: Laravel Boost on fortrabbit.
As a Claude Code plugin
The plugin bundles the skill and the MCP server. In Claude Code:
/plugin marketplace add fortrabbit/agent-skills
/plugin install fortrabbit@fortrabbit
Then run /mcp, pick the fortrabbit server and log in.
Use the plugin or one of the other installs for Claude Code, not both: each adds its own copy of the skill and the MCP server. To switch to the plugin, remove the other copies first:
frbit skills remove --agent claude-code --yes
claude mcp remove fortrabbit
Use the skill
There are no commands to learn. Ask the agent in plain words: "deploy this", "pull the production database", "why does the site return a 500?". The skill loads when a request is about fortrabbit, a frbit.app hostname or an environment ID. In Claude Code, /fortrabbit loads it on purpose, /fortrabbit:fortrabbit from the plugin.
The agent finds the environment from the git remote and the current branch. It shows a command before anything that changes a live environment and waits for a yes.
Update
Each install method updates the skill its own way:
# frbit CLI, with --project or --agent as at install
frbit skills update
# GitHub CLI
gh skill update fortrabbit
# npx
npx skills update fortrabbit
# Laravel Boost
composer update fortrabbit/laravel-boost && php artisan boost:update
# Claude Code plugin, MCP server included
claude plugin update fortrabbit@fortrabbit
Removing the skill, per install method: remove the agent setup.
Upgrade from version 1
Version 2 merges the fortrabbit-api-access skill into fortrabbit, drops the commands such as /fortrabbit db up, and drops the curl installer and the .fortrabbit project file. frbit skills update with CLI 1.7.0 or later removes the old files. After a gh skill install, delete them yourself:
rm -rf ~/.claude/skills/fortrabbit-api-access ~/.agents/skills/fortrabbit-api-access
Connect the MCP server
The skill works over SSH without the MCP server. Connected, the agent also lists and creates apps and environments, changes environment variables and reads deployment logs. Asked to connect, the skill walks through the setup.
Scripts and CI
Without a browser, a public API token takes the place of the login. The skill reads it from FORTRABBIT_API_TOKEN and never writes it to a committed file.
Requirements
gitandsshavailable locally, port 22 openrsyncfor file sync, a MySQL client for database work- On Windows, WSL is required for rsync; SSH works natively on Windows 10+