Habilidades de agente

Una habilidad de agente es una guía de trabajo que enseña a un agente de programación con IA a crear un tipo de cosa con un estilo terminado y con nombre: un video de lanzamiento de producto renderizado a partir de HTML, una presentación, una página de aterrizaje o un sitio completo, o un conjunto de imágenes editoriales. Cada habilidad es una carpeta, popnow-<slug>/, con un SKILL.md que el agente lee, además de los scripts, archivos de referencia y recursos que necesita.

Las habilidades son gratuitas. Los medios generados con una clave de API, incluidos el auxiliar REST de una habilidad o MCP con clave de API, gastan tu saldo independiente de la API en USD. Los medios de MCP con OAuth gastan créditos de la web. El saldo de la API en USD empieza en $0; añade fondos en API billing. Los créditos de la web y los fondos de la API no se pueden transferir ni usar uno en lugar del otro. Cuando una habilidad necesita una imagen, un clip de video, música o una voz en off, la genera a través de PopNow a los precios habituales de los modelos de Facturación de la API, y siempre te dice el precio antes de gastar nada. Explora todas las habilidades con vistas previas en popnow.ai/skills/agent-skills.

Hay dos formas de empezar:

• Desde un chat (recomendado). Con PopNow conectado como servidor MCP, di qué quieres crear. El asistente te muestra algunos estilos con vistas previas, eliges uno y PopNow entrega esa habilidad al asistente para que la lleve a cabo.
• Instálala tú mismo. Pega un prompt de instalación en tu agente, descarga el ZIP o descárgala con curl y tu clave de API.

De un vistazo

Elige una habilidad en un chat

Conecta PopNow una vez (Claude, ChatGPT, Claude Code, Cursor y otros) y pide el resultado que quieras. El asistente usa dos herramientas gratuitas:

1. find_skills compara lo que pediste con el catálogo y devuelve hasta cuatro estilos, del mejor al peor; cada uno con una descripción de una línea sobre el aspecto, para qué sirve mejor, un video de vista previa y una imagen de portada, qué medios puede generar con PopNow, qué necesita en tu equipo (Node.js, Python 3, FFmpeg, Chrome) y su página.
2. Eliges una.
3. use_skill devuelve la guía de trabajo completa de esa habilidad (SKILL.md), un enlace de descarga de todo el paquete que funciona durante unos minutos, los comandos exactos para instalarla en la carpeta de habilidades de tu agente, y cómo generar sus imágenes, video, música y voz con las herramientas de PopNow en la misma conexión.

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)

• Medios a través de PopNow. Las habilidades incluyen un pequeño script auxiliar para la API REST. Por MCP no hace falta clave de API: allí donde la guía de trabajo llama al script, el asistente usa en su lugar 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, o anime_to_real. Cada una cotiza primero, y todo lo que supere tu límite de confirmación automática espera tu sí, como se describe en Precios y confirmación.
• Qué agente. Si omites agent, PopNow lo adivina a partir de la app con la que te conectaste. En ChatGPT o Claude.ai (agent: "chat") no hay sistema de archivos: las habilidades de imagen siguen funcionando allí con create_image, mientras que las webs, las presentaciones y los videos renderizados necesitan un agente de programación; el asistente puede planificar contigo y generar los medios, y te da el enlace de descarga para más adelante.
• Límites. find_skills 240 y use_skill 120 llamadas por cuenta y por hora. Ambas son gratuitas y de solo lectura. Una habilidad nueva elegida con use_skill cuenta para tu límite de habilidades igual que una descarga; usar una que ya tienes nunca cuenta.

Instálala tú mismo

Con un prompt

Cada página de habilidad tiene Copy install prompt. Pégalo en tu agente; el agente lee la guía de instalación, elige su propia carpeta de habilidades y descarga el paquete con tu clave:

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.

Descarga el ZIP

Con la sesión iniciada en popnow.ai, Download ZIP en la página de la habilidad guarda popnow-<slug>.zip. Descomprímelo en una de las carpetas de abajo.

Con curl

Crea una clave en la consola de la API, expórtala como POPNOW_API_KEY y, después:

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

El archivo contiene una carpeta, popnow-<slug>/, con SKILL.md dentro. Algunos agentes cargan las habilidades nuevas solo en una sesión nueva.

La carpeta personal hace la habilidad disponible en todos los proyectos; la carpeta del proyecto, solo en ese repositorio.

Límites

Las habilidades son gratuitas, con un tope en cuántas habilidades distintas añade una cuenta. Los criterios de compra de créditos de la web que aparecen abajo determinan el acceso a las descargas de habilidades, no los fondos de la API; no permiten usar créditos de la web para llamadas a la API. El Download ZIP de la web, el endpoint de descarga y use_skill por MCP comparten ese tope.

• Volver a descargar es gratis. Una habilidad que ya añadiste se puede descargar, reinstalar o volver a elegir con use_skill en cualquier momento y desde cualquier dispositivo, y nunca vuelve a contar.
• Las 24 horas son continuas. Cada habilidad nueva libera un hueco 24 horas después de añadirla. Cuando llegas al tope, el mensaje indica cuándo se abre el siguiente hueco.
• Tu copia es tuya. Cada paquete que descargas lleva un ID de licencia de tu cuenta (en LICENSE.txt y en popnow-<slug>/.popnow-license.json). No cambia cómo funciona la habilidad; es la forma de distinguir tu copia con licencia de una filtrada, así que no publiques los paquetes.

Si superas el tope, el endpoint de descarga responde 429 con el código de negocio 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 es daily (con retryAfter en segundos, resetAt y una cabecera Retry-After) o lifetime (el total de 20 habilidades de las cuentas gratuitas; no hay nada que esperar). Por MCP, use_skill dice lo mismo con palabras sencillas en lugar de devolver la habilidad.

API REST

Los tres endpoints aceptan tu clave de API como token Bearer. Devuelven el catálogo y los pasos de instalación; la guía de trabajo viene con el paquete (o a través de use_skill por MCP).

Listar y buscar

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

Todos los filtros son opcionales. type es video, image, slides o web; task conserva las habilidades etiquetadas con una tarea (como landing-page o pitch-deck); q ordena por relevancia según un texto libre y deja fuera las habilidades que no coinciden con ninguna de sus palabras. Sin filtros obtienes el catálogo completo, del mejor al peor.

{
  "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 enumera los medios que la habilidad puede generar con PopNow; popnowRequired es true cuando la habilidad no puede terminar sin ellos. requires enumera las herramientas que ejecuta en tu equipo.

Una habilidad con pasos de instalación

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

La respuesta tiene los mismos campos más install: el nombre de la carpeta dentro del paquete, la ruta de descarga, el prompt de instalación, la guía de instalación y una entrada por agente con sus carpetas, cómo invocar la habilidad y un comando listo para ejecutar en la carpeta personal.

{
  "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 instalarla solo en un repositorio, ejecuta el comando con projectDir en lugar de personalDir.

Descarga

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

El endpoint responde 302 con un enlace firmado al ZIP que caduca a los pocos minutos; por eso sigue siempre la redirección (-L) y nunca guardes el enlace.

Errores y límites

¿Las habilidades de agente cuestan algo?

No. Buscar, instalar y ejecutar una habilidad es gratis. Solo se cobran las imágenes, clips de video, música y voces en off que genera a través de PopNow: las llamadas con clave de API gastan USD de la API; MCP con OAuth gasta créditos de la web, con el mismo precio de los modelos, y la habilidad cotiza cada una y espera tu sí.

¿Cuántas habilidades puedo conseguir?

Las cuentas gratuitas pueden añadir 5 habilidades nuevas al día y 20 en total; una vez que has comprado créditos, 30 habilidades nuevas al día sin límite total. Descargar una habilidad que ya tienes nunca cuenta. Consulta Límites.

¿Necesito un agente de programación?

Para webs, presentaciones y videos renderizados, sí: la habilidad ejecuta scripts y construye archivos en tu equipo. Las habilidades de imagen también funcionan en ChatGPT o Claude.ai una vez conectado PopNow por MCP, porque las imágenes se generan con create_image directamente en el chat.

¿Necesito una clave de API?

Por MCP, no: la conexión ya tiene sesión iniciada, use_skill da un enlace de descarga y los medios pasan por las herramientas de PopNow. Para la API REST, en las instalaciones con curl y en el script auxiliar de la habilidad, define POPNOW_API_KEY con una clave de la consola de la API.

¿Puedo compartir una habilidad o ponerla en mi repositorio?

Usa las habilidades para tu propio trabajo y para tus clientes, y quédate con lo que construyas con ellas. No publiques, reventas ni redistribuyas los paquetes en sí; envía a tus compañeros la página de la habilidad para que instalen su propia copia. Cada paquete descargado lleva un ID de licencia de la cuenta que lo descargó.

¿En qué se diferencia de popnow-skills en GitHub?

popnow-skills es un conjunto de código abierto que enseña a los agentes a llamar a la API de PopNow en general. Las habilidades de agente son estilos terminados, cada uno para un tipo de resultado, con vistas previas, que se eligen del catálogo de popnow.ai. Consulta SDK, CLI y herramientas de código abierto.

Relacionado