ShipStatic Docs llms.txt llms-full.txt

Ship Skill

An Agent Skill that teaches AI coding agents how to deploy and manage static sites using the CLI. View SKILL.md

curl --create-dirs -so .claude/skills/ship/SKILL.md https://www.shipstatic.com/SKILL.md

What It Does

The skill gives your AI agent knowledge of three workflows:

  1. Deploynpx -y @shipstatic/ship ./dist (no install needed)
  2. Reserve a domainship domains set www.example.com
  3. Link domain to deploymentship domains set www.example.com <id>

Plus the full CRUD reference for deployments and domains.

Agents can deploy without an API key — public deploys come back with a claim URL the user can visit to keep the site permanently.

Quick Start

Download the skill into your project:

curl --create-dirs -so .claude/skills/ship/SKILL.md https://www.shipstatic.com/SKILL.md

Your agent now knows how to install the CLI, authenticate, deploy, and manage domains.

Compatibility

The skill follows the Agent Skills open standard — a SKILL.md file with YAML frontmatter. Supported by:

  • Claude Code (.claude/skills/ship/)
  • Gemini CLI (.gemini/skills/ship/)
  • Cursor, GitHub Copilot, and 30+ tools

For cross-platform placement, use .agents/skills/ship/SKILL.md.

Authentication

Optional. The agent can deploy without authentication — the response includes a claim URL the user can visit later to keep the site permanently. For permanent deploys and management operations, the agent will prompt the user to run ship config or set the SHIP_API_KEY environment variable. See API Key.

Architecture

The skill contains no code. It is a single markdown file (~60 lines) with CLI commands and workflows. The agent reads it, then executes the CLI directly.