К основному содержанию
скилл CX Codex

openship-config — скилл для Claude Code: проектирует openship.json

Скилл openship-config, который готовит репозиторий к деплою на OpenShip: осматривает проект и создаёт openship.json с минимально необходимыми настройками. Пригодится перед первым запуском конфигурации или когда валидатор ругается.

Apache-2.0 ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install openship-skills@claude-settings
Открыть на GitHub

Что делает openship-config

Скилл работает по официальному рабочему процессу OpenShip: сначала осматривает репозиторий, затем объявляет только нужные переопределения, а остальное оставляет автоопределению. Смотрит на скрипты в package.json, lock-файлы, настройки фреймворка, Dockerfile, compose-файлы и существующий openship.json, если он уже есть.

Файл начинают с openship config init только когда его нет. Если конфиг уже существует, скилл сохраняет его и добавляет лишь то, что нужно переопределить. Поле $schema остаётся привязанным к https://openship.io/openship.schema.json. После правок запускается openship --json config validate той версией CLI, которая установлена. Ошибки чинятся, предупреждения просматриваются: редактор может ругаться на ключи, которые рантайм спокойно игнорирует.

openship.json описывает желаемую конфигурацию, но не доказывает, что домен переехал или деплой прошёл. Для запуска и живой проверки есть отдельный скилл openship-deploy. Секреты в коммите не хранятся: флаг secret: true управляет хранением после загрузки, а не шифрует значение в Git-файле. Примеры учётных данных из документации в репозиторий копировать нельзя.

Какие задачи решает

  • создать openship.json под структуру конкретного репозитория
  • разобраться, какие поля можно оставить автоопределению
  • исправить ошибки openship config validate
  • настроить compose-сервисы, порты, зависимости и постоянные тома
  • понять, где хранятся секреты и что делает secret: true

Примеры запросов агенту

  • Создай openship.json для этого репозитория
  • Проверь, что конфиг OpenShip валиден, и исправь ошибки
  • Объясни, почему валидатор ругается на openship config validate

Как установить openship-config

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-config -a claude-code

3Вручную: положить файлы

~/.claude/skills/openship-config/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/openship-config/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об openship-config

Как установить openship-config в Claude Code?

Через маркетплейс: сначала /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install openship-skills@claude-settings. Либо одной командой npx skills add fcakyon/claude-codex-settings --skill openship-config -a claude-code — файл попадёт в ~/.claude/skills/openship-config/SKILL.md.

Что делает скилл openship-config?

Осматривает репозиторий и проектирует openship.json: выбирает приложение или compose-сервисы, добавляет только переопределения поверх автоопределения и прогоняет openship --json config validate. Существующий конфиг он не переписывает с нуля.

Чем openship-config отличается от openship-deploy?

Этот скилл только проектирует и валидирует конфигурацию. Запуск деплоя и проверка, что домен реально переехал, — задача скилла openship-deploy. Один готовит файл, другой применяет его.

Исходный текст

SKILL.md · Apache-2.0
---
name: openship-config
description: This skill should be used when the user asks to "create openship.json", "configure an OpenShip deployment", "make a repo deployable on OpenShip", or fix "openship config validate" errors.
---

# Design openship.json

Use OpenShip's upstream configuration workflow: inspect the repo, declare only necessary overrides, then validate. Auto-detection supplies omitted fields. Prefer self-hosted deployment unless the user selects cloud.

## Design the configuration

1. Inspect package scripts, lockfiles, framework settings, Dockerfiles, compose files, workspace layout, and an existing `openship.json`.
2. Choose a single app, compose services, or detected monorepo apps. Do not combine those shapes casually. `monorepo.apps` overrides detected apps by root directory. It does not discover new applications.
3. Read [fields](references/fields.md) for names and meanings and the bundled [JSON schema](references/openship.schema.json) for editor validation. Use [compose guidance](references/compose-multi-service.mdx) for service topology, ports, dependencies, and persistent volumes.
4. Start with `openship config init` only when the file is absent. Preserve an existing config and add only values that need to override detection. Keep its `$schema` set to `https://openship.io/openship.schema.json`.
5. Run `openship --json config validate` using the deployment's CLI version. Fix errors and review warnings: unknown keys can be ignored by the runtime even though the editor schema rejects them.

A minimal server config can be:

```json
{
  "$schema": "https://openship.io/openship.schema.json",
  "port": 3000,
  "runtime": "docker",
  "domains": ["app.example.com"]
}
```

## Self-hosted details

- Self-hosted defaults to unlimited resources in the bundled release. Declare caps only when intended. Service-level caps override project caps field by field. Check target capacity separately from local config validation.
- Use named persistent volumes for state that must survive an application deploy. Expose only the services intended to receive public traffic.
- Keep actual secret values out of committed JSON. `secret: true` controls storage handling after ingestion. It does not encrypt a credential in a Git file. Read [environment variables](references/environment-variables.mdx) for instance-managed values.
- `openship.json` expresses desired configuration. It does not prove an existing domain has moved or the running deployment has changed. The companion `openship-deploy` skill handles deployment and live verification.

## Source and version

The workflow and [field reference](references/fields.md) derive from the official upstream config skill. [upstream.json](references/upstream.json) records the release and links to its CLI validator, runtime parser, types, parser tests, and deployment preparation code. Consult those sources when docs disagree or a behavior depends on the installed version. The parser and actual deployment implementation decide runtime behavior. The JSON schema serves editor validation.

Read the [configuration guide](references/openship-json.mdx) for additional examples. Do not copy example credentials into a repository.

© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
config-safety-reviewer alirezarezvani Субагент config-safety-reviewer проверяет конфиги на захардкоженные значения, неверные таймауты и лимиты пулов; его включают перед изменениями конфигурации. CX Codex ★ 788звёзд репо config-codex-cli cheaper-inference Скилл config-codex-cli для Claude Code настраивает Codex CLI через OmniRoute и проверяет конфигурацию. Он определяет ОС и shell. CX Codex +1 1 300установок GitLab Stack Config Generator rknall Скилл GitLab Stack Config Generator раскладывает конфиги nginx, PostgreSQL и Redis по ./config для GitLab-стека, тянет значения из .env и проверяет, что секреты не попали в файлы. CX Codex +1 303установок grepai-config-reference yoanbernabeu Скилл grepai-config-reference описывает все параметры файла .grepai/config.yaml — эмбеддер, хранилище, чанкинг, трассировку вызовов и правила игнорирования. CX Codex +1 727установок glab-config vince-winkintel Скилл glab-config управляет конфигурацией glab — CLI для GitLab: умолчания, прокси для каждого хоста, переменные цвета и редактора. CX Codex +1 129установок update-tab-config dominikmartn Скилл update-tab-config для Claude Code меняет существующие TOML-конфиги вкладок Warp по запросу на естественном языке. Работает с уже открытым или найденным файлом. CX Codex +1 ★ 720звёзд репо

Из того же набора113

Весь набор →
test-audit Скилл test-audit проверяет новые и изменённые тесты, а также помогает находить дубли и низкоценные проверки. Пригодится перед добавлением тестов и при аудите тестового набора. CX Codex +1 ★ 1 216звёзд репо webmcp-gen Скилл webmcp-gen собирает рабочий процесс сайта в WebMCP-инструмент и проверяет, что он ведёт себя так же, как существующий интерфейс. CX Codex +1 ★ 1 216звёзд репо start-environment Правило start-environment для Claude Code описывает запуск локального окружения через dev docker up: ожидание готовности сервисов и определение назначенных портов. CX Codex +1 ★ 1 216звёзд репо service-architecture Правило service-architecture описывает архитектуру Docker-сервисов Polar: общую инфраструктуру и отдельный стек приложения для каждого worktree. Помогает агенту учитывать связи между контейнерами и их адреса. CX Codex +1 ★ 1 216звёзд репо app-auth Скилл app-auth для Claude Code проектирует и настраивает аутентификацию. Включается при запросах на вход через соцсети, восстановление пароля, переключение аккаунтов и сохранение профиля. CX Codex +1 ★ 1 216звёзд репо gcloud-usage Скилл gcloud-usage помогает разбирать логи, метрики и трассировки Google Cloud, а также настраивать фильтры и алерты. Пригодится при отладке проблем в GCP. CX Codex +1 ★ 1 216звёзд репо dokploy-deploy Скилл dokploy-deploy подключает к агенту документацию Dokploy: облачную и self-hosted панель, деплой приложений и Docker Compose, базы, домены и индекс CLI-команд. CX Codex +1 ★ 1 216звёзд репо pr-reviewer Субагент pr-reviewer находит критические баги и проблемы безопасности в пулл-реквестах GitHub через консоль gh без лишнего шума в комментариях. CX Codex ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой