Agent skills

Uma agent skill é um playbook que ensina um agente de programação com IA a construir um tipo de coisa num estilo finalizado e com nome: um vídeo de lançamento de produto renderizado a partir de HTML, uma apresentação de slides, uma página de destino ou um site inteiro, um conjunto de imagens editoriais. Cada skill é uma pasta, popnow-<slug>/, com um SKILL.md que o agente lê, além dos scripts, arquivos de referência e recursos de que ele precisa.

As skills são gratuitas. Mídias geradas com chave de API, incluindo o auxiliar REST de uma skill ou MCP com chave de API, gastam seu saldo separado da API em USD. Mídias do MCP com OAuth gastam créditos do site. O saldo da API em USD começa em $0; adicione fundos em API billing. Créditos do site e fundos da API não podem ser transferidos nem usados um no lugar do outro. Quando uma skill precisa de uma imagem, um clipe de vídeo, uma música ou uma narração, ela a gera pela PopNow pelos preços normais dos modelos em Cobrança da API, e sempre informa o preço antes de gastar qualquer coisa. Veja todas as skills com prévias em popnow.ai/skills/agent-skills.

Há duas formas de começar:

• Por um chat (recomendado). Com a PopNow conectada como servidor MCP, diga o que quer criar. O assistente mostra alguns estilos com prévias, você escolhe um, e a PopNow entrega essa skill ao assistente para que ele a execute.
• Instalar você mesmo. Cole um prompt de instalação no seu agente, baixe o ZIP ou busque o pacote com curl e a sua chave de API.

Visão geral

Escolha uma skill num chat

Conecte a PopNow uma vez (Claude, ChatGPT, Claude Code, Cursor e outros) e peça o resultado que você quer. O assistente usa duas ferramentas gratuitas:

1. find_skills compara o seu pedido com o catálogo e devolve até quatro estilos, os melhores primeiro, cada um com uma descrição de uma linha do visual, para que serve melhor, um vídeo de prévia e uma imagem de capa, quais mídias ele consegue gerar pela PopNow, o que precisa na sua máquina (Node.js, Python 3, FFmpeg, Chrome) e a página dele.
2. Você escolhe um.
3. use_skill devolve o playbook completo dessa skill (SKILL.md), um link de download do pacote inteiro que funciona por alguns minutos, os comandos exatos para instalá-la na pasta de skills do seu agente, e como gerar as imagens, o vídeo, a música e a voz dela com as ferramentas da PopNow na mesma conexão.

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)

• Mídias pela PopNow. As skills trazem um pequeno script auxiliar para a API REST. Pelo MCP não é preciso chave de API: onde o playbook chama o script, o assistente usa 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, ou anime_to_real. Cada uma cota antes, e tudo o que passar do seu limite de confirmação automática espera o seu sim, como descrito em Preços e confirmação.
• Qual agente. Se você não passar agent, a PopNow adivinha pelo app que você conectou. No ChatGPT ou no Claude.ai (agent: "chat") não há sistema de arquivos: skills de imagem continuam funcionando por create_image, enquanto sites, apresentações e vídeos renderizados precisam de um agente de programação; o assistente pode planejar com você e gerar as mídias, e entrega o link de download para depois.
• Limites. find_skills 240 e use_skill 120 chamadas por conta por hora. Ambas são gratuitas e somente leitura. Uma skill nova escolhida com use_skill conta no seu limite de skills, como um download; usar uma que você já tem nunca conta.

Instale você mesmo

Com um prompt

Toda página de skill tem Copy install prompt. Cole-o no seu agente; o agente lê o guia de instalação, escolhe a própria pasta de skills e baixa o pacote com a sua chave:

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.

Baixe o ZIP

Com login no popnow.ai, Download ZIP na página da skill salva popnow-<slug>.zip. Descompacte-o em uma das pastas abaixo.

Com curl

Crie uma chave no console da API, exporte-a como POPNOW_API_KEY e depois:

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

O arquivo traz uma única pasta, popnow-<slug>/, com o SKILL.md dentro. Alguns agentes só carregam skills novas numa sessão nova.

A pasta pessoal torna a skill disponível em todos os projetos; a pasta do projeto, só naquele repositório.

Limites

As skills são gratuitas, com um teto para quantas skills diferentes uma conta adiciona. Os critérios de compra de créditos do site abaixo determinam o acesso a downloads de skills, não os fundos da API; não tornam créditos do site utilizáveis em chamadas da API. O Download ZIP do site, o endpoint de download e o use_skill pelo MCP compartilham esse teto.

• Baixar de novo é grátis. Uma skill que você já adicionou pode ser baixada, reinstalada ou escolhida de novo com use_skill a qualquer hora, em qualquer dispositivo, e nunca conta de novo.
• As 24 horas são contínuas. Cada skill nova libera uma vaga 24 horas depois de você tê-la adicionado. Quando você atinge o teto, a mensagem diz quando a próxima vaga abre.
• A sua cópia é sua. Cada pacote baixado traz um ID de licença da sua conta (em LICENSE.txt e em popnow-<slug>/.popnow-license.json). Isso não muda como a skill funciona; serve para distinguir a sua cópia licenciada de uma vazada, então, por favor, não publique os pacotes.

Acima do teto, o endpoint de download responde 429 com o código de negócio 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 (com retryAfter em segundos, resetAt e um cabeçalho Retry-After) ou lifetime (o total de 20 skills das contas gratuitas; não há o que esperar). Pelo MCP, use_skill diz a mesma coisa em palavras simples, em vez de devolver a skill.

API REST

Os três endpoints recebem a sua chave de API como token Bearer. Eles devolvem o catálogo e os passos de instalação; o playbook em si vem junto com o pacote (ou pelo use_skill no MCP).

Listar e buscar

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

Todos os filtros são opcionais. type é video, image, slides ou web; task mantém as skills marcadas com uma tarefa (como landing-page ou pitch-deck); q ordena pela relevância para o texto livre e deixa de fora as skills que não contêm nenhuma das palavras. Sem filtros, você recebe o catálogo inteiro, os melhores primeiro.

{
  "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 lista as mídias que a skill consegue gerar pela PopNow; popnowRequired é true quando a skill não consegue terminar sem elas. requires lista as ferramentas que ela executa na sua máquina.

Uma skill com os passos de instalação

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

A resposta traz os mesmos campos mais install: o nome da pasta dentro do pacote, o caminho de download, o prompt de instalação, o guia de instalação e uma entrada por agente, com as pastas dele, como chamar a skill e um comando pronto para a pasta pessoal.

{
  "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"
        },
        ...
      ]
    }
  }
}

Para instalar só em um repositório, rode o comando com projectDir no lugar de personalDir.

Download

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

O endpoint responde 302 com um link assinado para o ZIP, que expira em alguns minutos; por isso sempre siga o redirecionamento (-L) e nunca guarde o link.

Erros e limites

Agent skills custam alguma coisa?

Não. Encontrar, instalar e executar uma skill é grátis. Só são cobradas as imagens, os clipes de vídeo, as músicas e as narrações que ela gera pela PopNow: chamadas com chave de API gastam USD da API; MCP com OAuth gasta créditos do site, pelos mesmos preços dos modelos, e a skill cota cada um e espera o seu sim.

Quantas skills posso obter?

Contas gratuitas podem adicionar 5 skills novas por dia e 20 no total; depois que você comprar créditos, 30 skills novas por dia, sem limite total. Baixar uma skill que você já tem nunca conta. Veja Limites.

Preciso de um agente de programação?

Para sites, apresentações e vídeos renderizados, sim: a skill executa scripts e monta arquivos na sua máquina. Skills de imagem também funcionam no ChatGPT ou no Claude.ai, depois que a PopNow está conectada pelo MCP, porque as imagens são feitas com create_image dentro do próprio chat.

Preciso de uma chave de API?

Não pelo MCP: a conexão já está autenticada, o use_skill entrega um link de download e as mídias passam pelas ferramentas da PopNow. Para a API REST, o curl instala e o script auxiliar da própria skill usa POPNOW_API_KEY, definida com uma chave do console da API.

Posso compartilhar uma skill ou colocá-la no meu repositório?

Use as skills no seu próprio trabalho e para os seus clientes, e mantenha o que você cria com elas. Não publique, revenda nem redistribua os pacotes em si; envie aos colegas a página da skill para que instalem a cópia deles. Todo pacote baixado traz um ID de licença da conta que o baixou.

Qual é a diferença para o popnow-skills no GitHub?

O popnow-skills é um conjunto de código aberto que ensina agentes a chamar a API da PopNow em geral. As agent skills são estilos finalizados, cada um para um tipo de resultado, com prévias, escolhidos no catálogo do popnow.ai. Veja SDKs, CLI e ferramentas de código aberto.

Relacionados