PiratePressPiratePress

Скилл PiratePress для Claude Code, Kimi Code и Cursor

«Скилл PiratePress» — это пакет инструкций, который превращает твоего AI-агента в оператора видео-конвейера: агент учится писать сценарии, заказывать ролики через API, проверять результат и забирать готовые mp4. Разберём, что внутри и как это использовать.

Что нужно подготовить

  1. AI-агент с доступом к shell — Claude Code, Kimi Code, Cursor или веб-агент с терминалом.
  2. API-ключ из бота: @piratepress_bot → /apikey (показывается один раз).
  3. Пара минут на установку.

Как поставить и что умеет скилл

Шаг 1. Установи. Через skills CLI одной командой:

npx skills add piratepress/agents

Либо однострочником curl -fsSL https://piratepress.fun/install.sh | PIRATEPRESS_API_KEY=pp_... bash — он поставит и скилл, и MCP-сервер, зарегистрировав всё в найденных агентах автоматически.

Шаг 2. Пойми, что меняет скилл. Это не код, а экспертиза: агент получает полную карту публичного API — эндпоинты, параметры, типичные связки, цены, режимы работы. После установки достаточно сказать «сделай ролик про …», и агент сам пройдёт флоу: проверит баланс, сформирует заказ, дождётся готовности, скачает mp4 и постинг-пак.

Шаг 3. Выбери режим работы. Скилл самодостаточен: весь REST-флоу внутри работает на curl — подходит даже агентам без MCP (например, веб-агентам с shell). Если MCP-сервер установлен, скилл предпочитает его инструменты (generate_video, wait_video и др.) — тот же API, но меньше рутины.

Шаг 4. Дай агенту реальную задачу. Сценарии из практики контент-ферм:

  • Разовый ролик: «30-секундный EN-ролик про то, почему зимой гибнут комнатные растения» → заказ → mp4.
  • Партия: «5 роликов по этим темам, проверь баланс заранее» → агент считает стоимость, заказывает, собирает все mp4 и метаданные для постинга.
  • Конвейер по расписанию: агент раз в сутки генерирует партию роликов из RSS/заметок и складывает в папку на публикацию.
  • Ревью качества: в режиссёрском режиме агент читает сценарий до рендера и правит его под твой стиль.

Частые ошибки

Скилл без ключа. Инструкции есть, а денег нет: без PIRATEPRESS_API_KEY агент упрётся в 401. Ключ — в боте, командой /apikey.

Расплывчатые заказы в потоке. Для серий проси агента использовать явные параметры (generate_video), а не свободный промпт: предсказуемая цена и результат.

Нет контроля расхода. Агент с доступом к API умеет тратить дублоны. Задавай рамки явно: «не больше N роликов», «сначала покажи смету» — скилл учит агента сверяться с балансом.

Частые вопросы

Чем скилл отличается от MCP-сервера? Скилл — знания и флоу (работает везде, где есть shell). MCP — готовые инструменты с прогрессом и ожиданием. Вместе — лучший вариант; по отдельности каждый самодостаточен.

Какие агенты поддерживаются? Любые, куда ставится skills CLI: Claude Code, Kimi Code, Cursor и другие — установщик детектит их автоматически.

Можно ли изменить скилл под себя? Да, репозиторий piratepress/agents открыт — форкай и дописывай свои правила производства.

Это безопасно? Скилл работает с твоим ключом локально, ничего не отправляет третьим сторонам; ключ отзывается перевыпуском в боте.

Можно ли использовать скилл в CI/CD? Да: весь флоу — это curl по REST API, поэтому пайплайн собирается из обычных шагов: заказ → поллинг → скачивание. Ключ клади в секреты раннера.

Что если агент ошибся в параметрах? API валидирует заказ: конфликтующие параметры вернут 422 с объяснением, а не сожгут дублоны. Скилл учит агента читать такие ответы и исправлять заказ.

Работает ли скилл с самописными агентами? Да: инструкции платформенно-нейтральны. Если твой агент умеет читать markdown-инструкции и дёргать shell — он справится.

Как откатить или обновить скилл? Установка повторяется той же командой — свежая версия подтянется из репозитория. Откат — git-история репозитория piratepress/agents, она открыта.

Что входит в флоу ревью? В режиссёрском режиме агент получает текст сценария до рендера и может утвердить, поправить или отправить на перегенерацию с пожеланием. Это штатный способ держать стиль канала при полной автоматизации.

Установка — одна команда: забери ключ в @piratepress_bot и выполни npx skills add piratepress/agents — дальше агент делает ролики сам.