Агентские навыки

Агентский навык — это инструкция, которая учит ИИ-агента для программирования создавать один вид результата в одном готовом, названном стиле: ролик-презентацию продукта, собранный из HTML, слайд-презентацию, лендинг или целый сайт, набор редакционных изображений. Каждый навык — это папка popnow-<slug>/ с файлом SKILL.md, который читает агент, а также скрипты, справочные файлы и ресурсы, которые ему нужны.

Навыки бесплатны. Медиа, созданные с API-ключом, в том числе через REST-скрипт навыка или MCP с API-ключом, расходуют отдельный баланс API в USD. Медиа через OAuth MCP расходуют кредиты сайта. Начальный баланс API — $0; пополните его в разделе Оплата API. Переводить средства между балансами или использовать один вместо другого нельзя. Когда навыку нужны картинка, видеоклип, музыка или озвучка, он создаёт их через PopNow по обычным ценам моделей из раздела Оплата API и всегда называет цену до того, как что-либо будет потрачено. Просмотреть все навыки с превью можно на popnow.ai/skills/agent-skills.

Есть два способа начать:

• Из чата (рекомендуется). Подключив PopNow как MCP-сервер, скажите, что хотите сделать. Ассистент покажет несколько стилей с превью, вы выбираете один, и PopNow передаёт этот навык ассистенту для выполнения.
• Установите сами. Вставьте промпт установки в своего агента, скачайте ZIP или получите его через curl и свой API-ключ.

Коротко

Выбор навыка в чате

Подключите PopNow один раз (Claude, ChatGPT, Claude Code, Cursor и другие) и попросите нужный результат. Ассистент использует два бесплатных инструмента:

1. find_skills сопоставляет ваш запрос с каталогом и возвращает до четырёх стилей, лучшие первыми. У каждого есть однострочное описание внешнего вида, то, для чего он лучше всего подходит, превью-видео и обложка, какие медиа он может создать через PopNow, что нужно на вашем компьютере (Node.js, Python 3, FFmpeg, Chrome) и его страница.
2. Вы выбираете один.
3. use_skill возвращает полную инструкцию навыка (SKILL.md), ссылку на скачивание всего пакета, действующую несколько минут, точные команды для установки в папку навыков вашего агента и способ создать его изображения, видео, музыку и озвучку инструментами PopNow в том же подключении.

You:        Make a product launch video for my note-taking app.
Assistant:  (calls find_skills with intent "product launch video for a note-taking app")
            Here are four styles:
            1. Device Mockup Launch Video: your real app screen on a device in a dark studio. [preview]
            2. Seamless App Promo Sting: a 10–13 second promo that flows as one camera move. [preview]
            3. AI Chat Product Demo Video: a narrated demo inside a chat app. [preview]
            4. Developer Tool Launch Reel: one prompt in four places, then your install command. [preview]
            Which one do you like?
You:        The first one.
Assistant:  (calls use_skill with slug "device-mockup-launch-video" and agent "claude-code")
            (downloads and unzips the package into ~/.claude/skills, then follows the playbook)
            I need two screenshots of your app. The background music is about 72 credits. Shall I make it?
You:        Yes.
Assistant:  (calls create_music, renders the video locally, saves launch.mp4)

• Медиа через PopNow. В навыки входит небольшой вспомогательный скрипт для REST API. Через MCP API-ключ не нужен: там, где инструкция вызывает скрипт, ассистент вместо этого использует create_image, edit_image, create_video, create_music, create_speech, add_sound, compose_video, upscale, remove_background, extend_video, edit_video, copy_motion, create_video_from_references, transcribe_audio, create_sound_effects, split_layers, erase_object, expand_image, change_camera_angle, change_pose, relight_photo, remove_shadow, или anime_to_real. Каждый сначала называет котировку, а всё, что превышает ваш лимит автоматического подтверждения, ждёт вашего согласия, как описано в Цены и подтверждение.
• Какой агент. Если не указать agent, PopNow угадает его по приложению, через которое вы подключились. В ChatGPT или Claude.ai (agent: "chat") нет файловой системы: навыки с изображениями там всё равно работают через create_image, а сайты, презентации и готовые видео требуют агента для программирования. Ассистент может спланировать работу вместе с вами и создать медиа, а ссылку на скачивание даст на потом.
• Лимиты. find_skills — 240, use_skill — 120 вызовов на аккаунт в час. Оба бесплатны и только для чтения. Новый навык, выбранный через use_skill, учитывается в вашем лимите навыков так же, как скачивание; использование уже имеющегося навыка никогда не учитывается.

Установка вручную

Промптом

На каждой странице навыка есть кнопка Copy install prompt. Вставьте её в своего агента: агент прочитает руководство по установке, выберет свою папку навыков и загрузит пакет с вашим ключом:

Install the PopNow skill "Dark SaaS Landing Page" (dark-saas-landing-page) for me by following https://popnow.ai/skills/install.md. My PopNow API key is in the POPNOW_API_KEY environment variable.

Скачайте ZIP

Войдя на popnow.ai, нажмите Download ZIP на странице навыка: сохранится popnow-<slug>.zip. Распакуйте его в одну из папок ниже.

Через curl

Создайте ключ в API-консоли, экспортируйте его как POPNOW_API_KEY, затем:

mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fL -H "Authorization: Bearer $POPNOW_API_KEY" \
  https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download -o popnow-dark-saas-landing-page.zip
unzip -o popnow-dark-saas-landing-page.zip && rm popnow-dark-saas-landing-page.zip

В архиве одна папка popnow-<slug>/, внутри которой лежит SKILL.md. Некоторые агенты подхватывают новые навыки только в новой сессии.

Личная папка делает навык доступным во всех проектах; папка проекта — только в этом репозитории.

Лимиты

Навыки бесплатны, но есть предел на то, сколько разных навыков может добавить один аккаунт. Условия покупки кредитов сайта ниже определяют доступ к скачиванию навыков, а не пополнение API; они не позволяют оплачивать вызовы API кредитами сайта. Кнопка Download ZIP на сайте, эндпоинт скачивания и use_skill через MCP используют один и тот же лимит.

• Повторное скачивание бесплатно. Навык, который вы уже добавили, можно в любой момент скачать, переустановить или снова выбрать через use_skill на любом устройстве — и он больше не учитывается.
• Скользящие 24 часа. Каждый новый навык освобождает место через 24 часа после добавления. Когда вы упираетесь в лимит, сообщение говорит, когда откроется следующее место.
• Ваша копия — ваша. Каждый скачанный пакет несёт ID лицензии вашего аккаунта (в LICENSE.txt и popnow-<slug>/.popnow-license.json). Он не меняет работу навыка; по нему мы отличаем вашу лицензионную копию от утёкшей, поэтому, пожалуйста, не публикуйте пакеты.

Сверх лимита эндпоинт скачивания отвечает 429 с бизнес-кодом 42901:

{
  "code": 42901,
  "msg": "You've added 5 new skills in the last 24 hours, the daily limit for free accounts. You can add another in about 3 hours (at 13:00 on Oct 23 UTC). Skills you already added can be downloaded again anytime. Accounts that have bought credits can add 30 a day: popnow.ai/pricing",
  "data": {
    "reason": "skill_quota",
    "scope": "daily",
    "limit": 5,
    "used": 5,
    "paid": false,
    "retryAfter": 10800,
    "resetAt": "2026-10-23T13:00:00Z",
    "upgradeUrl": "https://popnow.ai/pricing"
  },
  "request_id": "req_..."
}

scope — это daily (с retryAfter в секундах, resetAt и заголовком Retry-After) или lifetime (общий лимит 20 навыков для бесплатных аккаунтов; ждать нечего). Через MCP use_skill говорит то же самое обычными словами вместо того, чтобы вернуть навык.

REST API

Все три эндпоинта принимают ваш API-ключ как Bearer-токен. Они возвращают каталог и шаги установки; сама инструкция идёт вместе с пакетом (или через use_skill по MCP).

Список и поиск

curl "https://api.popnow.ai/api/v1/agent-skills?type=slides&q=pitch%20deck" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Все фильтры необязательны. type — это video, image, slides или web; task оставляет навыки с одной задачей (например, landing-page или pitch-deck); q ранжирует по релевантности свободного текста и не показывает навыки, в которых не совпало ни одно слово. Без фильтров вы получите весь каталог, лучшие первыми.

{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [
      {
        "slug": "dark-saas-landing-page",
        "name": "Dark SaaS Landing Page",
        "summary": "A dark, motion-rich marketing site for a software product, delivered as one self-contained HTML file.",
        "bestFor": ["Launch pages for SaaS and developer tools", "A full marketing site that has to look shipped on day one"],
        "type": "web",
        "tasks": ["landing-page"],
        "popnow": ["image"],
        "popnowRequired": false,
        "requires": ["node", "python3", "chrome"],
        "version": "1.0.0",
        "updated": "2026-10-22",
        "url": "https://popnow.ai/skills/dark-saas-landing-page",
        "preview": {
          "video": "https://media.popnow.ai/skills/library/dark-saas-landing-page/cover.9cfd8efc.mp4",
          "image": "https://popnow.ai/skills/library/media/dark-saas-landing-page/poster.webp"
        },
        "distribution": "popnow"
      }
    ],
    "total": 1
  }
}

popnow перечисляет медиа, которые навык может создать через PopNow; popnowRequired равен true, когда навык не может завершиться без них. requires перечисляет инструменты, на которых он работает на вашем компьютере.

Один навык с шагами установки

curl https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page \
  -H "Authorization: Bearer $POPNOW_API_KEY"

В ответе те же поля плюс install: имя папки внутри пакета, путь для скачивания, промпт установки, руководство по установке и по одной записи на каждого агента с его папками, способом вызова навыка и готовой командой для личной папки.

{
  "code": 200,
  "msg": "success",
  "data": {
    "slug": "dark-saas-landing-page",
    "name": "Dark SaaS Landing Page",
    "type": "web",
    "url": "https://popnow.ai/skills/dark-saas-landing-page",
    ...
    "install": {
      "folder": "popnow-dark-saas-landing-page",
      "downloadPath": "/api/v1/agent-skills/dark-saas-landing-page/download",
      "downloadUrl": "https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download",
      "prompt": "Install the PopNow skill \"Dark SaaS Landing Page\" (dark-saas-landing-page) for me by following https://popnow.ai/skills/install.md. My PopNow API key is in the POPNOW_API_KEY environment variable.",
      "guide": "https://popnow.ai/skills/install.md",
      "agents": [
        {
          "id": "claude-code",
          "name": "Claude Code",
          "personalDir": "~/.claude/skills",
          "projectDir": ".claude/skills",
          "invoke": "/popnow-dark-saas-landing-page",
          "docs": "https://docs.claude.com/en/docs/claude-code/skills",
          "command": "mkdir -p ~/.claude/skills && cd ~/.claude/skills\ncurl -fL -H \"Authorization: Bearer $POPNOW_API_KEY\" \\\n  https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download -o popnow-dark-saas-landing-page.zip\nunzip -o popnow-dark-saas-landing-page.zip && rm popnow-dark-saas-landing-page.zip"
        },
        ...
      ]
    }
  }
}

Чтобы установить навык только для одного репозитория, выполните команду, подставив projectDir вместо personalDir.

Скачивание

curl -fL https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -o popnow-dark-saas-landing-page.zip

Эндпоинт отвечает 302 с подписанной ссылкой на ZIP, которая истекает через несколько минут, поэтому всегда следуйте редиректу (-L) и никогда не сохраняйте ссылку.

Ошибки и лимиты

Агентские навыки что-нибудь стоят?

Нет. Поиск, установка и запуск навыка бесплатны. Платят только за изображения, видеоклипы, музыку и озвучку, которые навык создаёт через PopNow: вызовы с API-ключом расходуют USD API, OAuth MCP — кредиты сайта, по одной и той же цене модели. Навык называет котировку каждого результата и ждёт вашего согласия.

Сколько навыков я могу получить?

Бесплатные аккаунты могут добавить 5 новых навыков в день и 20 всего; после покупки кредитов — 30 новых навыков в день без общего лимита. Скачивание навыка, который у вас уже есть, никогда не учитывается. См. Лимиты.

Нужен ли агент для программирования?

Для сайтов, презентаций и готовых видео — да: навык запускает скрипты и собирает файлы на вашем компьютере. Навыки с изображениями работают и в ChatGPT или Claude.ai, когда PopNow подключён по MCP, потому что картинки создаются через create_image прямо в чате.

Нужен ли API-ключ?

Через MCP — нет: подключение уже выполнило вход, use_skill даёт ссылку на скачивание, а медиа идут через инструменты PopNow. Для REST API нужны curl для установки и вспомогательный скрипт навыка: задайте POPNOW_API_KEY равным ключу из API-консоли.

Можно ли поделиться навыком или положить его в свой репозиторий?

Используйте навыки для своей работы и для клиентов и оставляйте себе то, что с их помощью создали. Не публикуйте, не перепродавайте и не распространяйте сами пакеты; отправьте коллегам страницу навыка, чтобы они установили свою копию. Каждый скачанный пакет несёт ID лицензии того аккаунта, который его скачал.

Чем это отличается от popnow-skills на GitHub?

popnow-skills — это набор с открытым исходным кодом, который учит агентов вызывать PopNow API в целом. Агентские навыки — это готовые стили, каждый для одного вида результата, с превью, которые выбирают из каталога на popnow.ai. См. SDK, CLI и инструменты с открытым исходным кодом.

Связанное