openship-deploy — скилл для Claude Code: что делает и как установить
Скилл openship-deploy для развёртывания и сопровождения самостоятельного инстанса OpenShip через CLI: деплой приложений, домены, бэкапы, обновления.
Apache-2.0 ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install openship-skills@claude-settingsЧто делает openship-deploy
Скилл подключается, когда пользователь просит «задеплоить через OpenShip», разобраться с самостоятельным инстансом или починить упавший деплой. Он работает через CLI: сначала проверяет openship --version и openship context list, чтобы агент не перепутал контекст и не полез в чужой сервер. Дальше — конфиг openship.json (через скилл-компаньон openship-config), валидация командой openship --json config validate и сам деплой из репозитория или папки.
После деплоя скилл проверяет статус, здоровье сервиса, логи и публичный URL, и отдельно обрабатывает домены, откат на предыдущую версию и постоянное хранилище для данных, которые должны выжить после редеплоя. Для сопровождения инстанса есть отдельные справочники по обновлениям, бэкапам и переносу контрол-плейна.
В версии 0.8.0 команда server ssh — заглушка, хотя и показывается в --help: успешный вызов справки не гарантирует, что операция реально работает.
Какие задачи решает
- задеплоить приложение из репозитория через OpenShip CLI
- проверить статус и логи после деплоя
- настроить домены и SSL для сервиса
- откатиться на предыдущую версию или пересобрать её с нуля
- сделать бэкап и восстановить данные самостоятельного инстанса
Примеры запросов агенту
- Задеплой этот репозиторий через OpenShip и проверь публичный URL после деплоя
- Разберись, почему последний деплой на OpenShip упал в красный статус, и покажи логи
- Настрой кастомный домен для сервиса в OpenShip и проверь выпуск сертификата
Как установить openship-deploy
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install openship-skills@claude-settingsКоманда ставит плагин openship-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill openship-deploy -a claude-code3Вручную: положить файлы
~/.claude/skills/openship-deploy/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/openship-deploy/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill openship-deploy -a codex2Вручную: положить файлы
.agents/skills/openship-deploy/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill openship-deploy -a cursor2Вручную: положить файлы
.cursor/skills/openship-deploy/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fcakyon/claude-codex-settings plugins/openship-skills/skills/openship-deploy2Вручную: положить файлы
.github/skills/openship-deploy/SKILL.md1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill openship-deploy -a gemini-cli2Командой платформы
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/openship-skills/skills/openship-deployВручную: положить файлы
.devin/skills/openship-deploy/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об openship-deploy
Как установить openship-deploy в Claude Code?
Выполните /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install openship-skills@claude-settings.
Что делает openship-deploy?
Скилл помогает разворачивать приложения через OpenShip CLI и обслуживать самостоятельный инстанс: домены, хранилище, бэкапы и обновления.
Нужен ли уже работающий сервер OpenShip?
Скилл рассчитан на работу с существующим самостоятельным инстансом и выбранным контекстом CLI; облачный или десктопный режим используется только по явной просьбе.
Исходный текст
SKILL.md · Apache-2.0
--- name: openship-deploy description: This skill should be used when the user asks to "deploy with OpenShip", "manage a self-hosted OpenShip instance", "debug an OpenShip deployment", or manage its domains, storage, backups, or upgrades through the CLI. --- # Deploy and operate OpenShip Prefer the CLI and an existing self-hosted instance. Use a cloud or desktop workflow when the user requests it. Keep application deployments separate from installing or upgrading the OpenShip control plane. ## Choose the instance and command - Check `openship --version` and `openship context list`. Select the intended self-hosted context before a remote operation. Never assume the active context points to the user's server. - Use native commands with the global `--json` flag. Read [CLI access](references/cli/access.mdx) for context and authentication details, and [automation](references/cli/automation.mdx) for CI logins and scripts that pass explicit project IDs. Do not print stored tokens. - Check the installed command's `--help`. Use `openship api` for routes without a working command, after checking the matching implementation. In v0.8.0, `server ssh` is a stub despite appearing in help. A successful help command does not prove an operation works. - [upstream.json](references/upstream.json) records the bundled release, exact source URLs, and hashes. If the installed CLI or server differs, verify the relevant source at that version before relying on a flag or API contract. ## Deploy an application 1. Inspect the repository, existing project link, build entry point, service topology, persistent volumes, and current domain ownership. Use [projects and services](references/cli/projects.mdx) for commands. 2. Use the companion `openship-config` skill to author a small `openship.json`. When only this ZIP is installed, use the [official config guide](https://openship.io/docs/guides/openship-json). Keep repeatable build and routing choices in the repository. Keep actual credentials in the instance's environment settings. 3. Run `openship --json config validate`, then use [deployment commands](references/cli/deploy.mdx) for the appropriate repository or folder deploy. A valid file does not prove its image builds or that the destination has sufficient capacity. 4. Check deployment completion, the active deployment, service health, logs, and the public URL. Report the deployed revision and any checks still pending. Use [edge and monitoring](references/cli/edge.mdx) and [logs](references/guides/logs-monitoring.mdx) for diagnosis, and [build failures](references/troubleshooting/deployments.mdx) when the deploy goes red. Read only the guide needed for the operation: - [Self-hosted GitHub App](references/guides/self-hosted-github-app.mdx): repository authorization and automatic deployment. - [Domains](references/guides/custom-domains.mdx): ownership, DNS, ports, and HTTPS. Reconcile existing ownership before moving a hostname. [Domain and SSL failures](references/troubleshooting/domains-ssl.mdx) covers certificates that do not issue. - [Rollback and redeploy](references/guides/rollback-redeploy.mdx): return to a previous version or rebuild one from scratch. - [Persistent storage](references/guides/persistent-storage.mdx): volumes and data that must survive redeployment. ## Maintain the self-hosted instance Use [self-host infrastructure](references/cli/self-host.mdx) for servers and backups, and [running OpenShip](references/cli/run.mdx) for lifecycle commands. Inspect how the instance was installed and whether it has a custom updater before selecting an upgrade command. - [Updates](references/guides/updating.mdx): CLI and server lifecycle. - [Backups and restore](references/guides/backups-restore.mdx): protection and recovery of application data. - [Instance migration](references/guides/migrate-control-plane.mdx): control-plane export and import. Use the user's existing authorization for the requested operation. Preparing a deployment is not authorization to replace a running instance or restore over its data.
© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings