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.

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
shell

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
shell

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
shell

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
shell

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
shell

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
shell

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
shell

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
shell

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

  • git and ssh available locally, port 22 open
  • rsync for file sync, a MySQL client for database work
  • On Windows, WSL is required for rsync; SSH works natively on Windows 10+

Written by humans and AI in collaboration.

AI use & editorial processEdit on GitHub ↗