Compétences d’agent

Une compétence d’agent est un guide qui apprend à un agent de code IA à réaliser un type de travail dans un style fini et nommé : une vidéo de lancement de produit générée à partir de HTML, un diaporama, une page d’accueil ou un site complet, un ensemble d’images éditoriales. Chaque compétence est un dossier, popnow-<slug>/, contenant un SKILL.md que l’agent lit, ainsi que les scripts, fichiers de référence et ressources dont il a besoin.

Les compétences sont gratuites. Les médias produits avec une clé API, y compris par le script REST d’une compétence ou par MCP avec clé API, dépensent votre solde API séparé en USD. Les médias MCP par OAuth utilisent les crédits du site. Le solde API commence à $0 ; approvisionnez-le dans Facturation API. Les crédits du site et les fonds API ne peuvent être ni transférés ni utilisés les uns à la place des autres. Quand une compétence a besoin d’une image, d’un clip vidéo, de musique ou d’une voix off, elle les produit via PopNow aux prix habituels des modèles indiqués dans Facturation API, en annonçant toujours le prix avant toute dépense. Parcourez toutes les compétences avec leurs aperçus sur popnow.ai/skills/agent-skills.

Il y a deux façons d’y accéder :

• Depuis une conversation (recommandé). Avec PopNow connecté comme serveur MCP, dites ce que vous voulez créer. L’assistant présente quelques styles avec leurs aperçus, vous en choisissez un, et PopNow remet cette compétence à l’assistant pour qu’il la réalise.
• L’installer vous-même. Collez un prompt d’installation dans votre agent, téléchargez le ZIP, ou récupérez-le avec curl et votre clé API.

En bref

Choisir une compétence dans une conversation

Connectez PopNow une fois (Claude, ChatGPT, Claude Code, Cursor et autres) et demandez le résultat voulu. L’assistant utilise deux outils gratuits :

1. find_skills compare votre demande avec le catalogue et renvoie jusqu’à quatre styles, les meilleurs d’abord, chacun avec une description d’une ligne sur le rendu, ce pour quoi il convient le mieux, une vidéo d’aperçu et une image de couverture, les médias qu’il peut produire avec PopNow, ce qu’il demande sur votre machine (Node.js, Python 3, FFmpeg, Chrome) et sa page.
2. Vous en choisissez un.
3. use_skill renvoie le guide complet de cette compétence (SKILL.md), un lien de téléchargement du paquet entier valable quelques minutes, les commandes exactes pour l’installer dans le dossier de compétences de votre agent, et la manière de produire ses images, sa vidéo, sa musique et sa voix avec les outils PopNow de la même connexion.

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 via PopNow. Les compétences livrent un petit script d’aide pour l’API REST. Sur MCP, aucune clé API n’est nécessaire : là où le guide appelle le script, l’assistant utilise 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 à la place. Chacun annonce son prix d’abord, et tout ce qui dépasse votre limite de confirmation automatique attend votre accord, comme décrit dans Prix et confirmation.
• Quel agent. Si vous omettez agent, PopNow devine d’après l’application avec laquelle vous êtes connecté. Dans ChatGPT ou Claude.ai (agent: "chat"), il n’y a pas de système de fichiers : les compétences d’image fonctionnent quand même via create_image, tandis que les sites, les diaporamas et les vidéos rendues demandent un agent de code ; l’assistant peut planifier avec vous et produire les médias, puis vous donne le lien de téléchargement pour plus tard.
• Limites. find_skills 240 et use_skill 120 appels par compte et par heure. Les deux sont gratuits et en lecture seule. Une nouvelle compétence choisie avec use_skill compte dans votre limite de compétences comme un téléchargement ; utiliser une compétence déjà possédée ne compte jamais.

L’installer vous-même

Avec un prompt

Chaque page de compétence propose Copy install prompt. Collez-le dans votre agent : celui-ci lit le guide d’installation, choisit son propre dossier de compétences et récupère le paquet avec votre clé :

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.

Télécharger le ZIP

Connecté sur popnow.ai, Download ZIP sur la page de la compétence enregistre popnow-<slug>.zip. Décompressez-le dans l’un des dossiers ci-dessous.

Avec curl

Créez une clé dans la console API, exportez-la sous POPNOW_API_KEY, puis :

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

L’archive contient un seul dossier, popnow-<slug>/, avec SKILL.md à l’intérieur. Certains agents ne chargent les nouvelles compétences qu’à l’ouverture d’une nouvelle session.

Le dossier personnel rend la compétence disponible dans tous vos projets ; le dossier du projet ne la rend disponible que dans ce dépôt.

Limites

Les compétences sont gratuites, avec une limite au nombre de compétences différentes qu’un compte ajoute. Les critères d’achat de crédits du site ci-dessous déterminent l’accès aux téléchargements, pas l’approvisionnement API ; ils ne rendent pas les crédits du site utilisables pour les appels API. Download ZIP sur le site, le point d’accès de téléchargement et use_skill via MCP partagent cette limite.

• Retélécharger est gratuit. Une compétence déjà ajoutée peut être téléchargée, réinstallée ou choisie de nouveau avec use_skill à tout moment, sur n’importe quel appareil, sans jamais compter à nouveau.
• Les 24 heures glissent. Chaque nouvelle compétence libère une place 24 heures après que vous l’avez ajoutée. Quand vous atteignez le plafond, le message indique à quel moment la prochaine place s’ouvre.
• Votre copie vous appartient. Chaque paquet téléchargé porte un identifiant de licence pour votre compte (dans LICENSE.txt et popnow-<slug>/.popnow-license.json). Cela ne change pas le fonctionnement de la compétence ; cela nous permet de distinguer votre copie sous licence d’une copie fuitée. Merci de ne pas publier les paquets.

Au-delà du plafond, l’endpoint de téléchargement répond 429 avec le code métier 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 vaut daily (avec retryAfter en secondes, resetAt et un en-tête Retry-After) ou lifetime (le total de 20 compétences pour les comptes gratuits ; rien à attendre). Via MCP, use_skill dit la même chose en termes simples au lieu de renvoyer la compétence.

API REST

Les trois endpoints acceptent votre clé API comme jeton Bearer. Ils renvoient le catalogue et les étapes d’installation ; le guide lui-même vient avec le paquet (ou via use_skill sur MCP).

Lister et chercher

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

Tous les filtres sont facultatifs. type vaut video, image, slides ou web ; task garde les compétences associées à une tâche (comme landing-page ou pitch-deck) ; q classe par pertinence pour un texte libre et écarte les compétences qui ne correspondent à aucun de ses mots. Sans filtre, vous obtenez tout le catalogue, les meilleurs d’abord.

{
  "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 liste les médias que la compétence peut produire via PopNow ; popnowRequired vaut true quand la compétence ne peut pas aboutir sans eux. requires liste les outils qu’elle utilise sur votre machine.

Une compétence avec ses étapes d’installation

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

La réponse contient les mêmes champs, plus install : le nom du dossier dans le paquet, le chemin de téléchargement, le prompt d’installation, le guide d’installation, et une entrée par agent avec ses dossiers, la manière d’appeler la compétence et une commande prête à lancer pour le dossier personnel.

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

Pour installer seulement dans un dépôt, lancez la commande en remplaçant personalDir par projectDir.

Télécharger

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

L’endpoint répond 302 avec un lien signé vers le ZIP, qui expire au bout de quelques minutes. Suivez donc toujours la redirection (-L) et ne conservez jamais le lien.

Erreurs et limites

Les compétences d’agent coûtent-elles quelque chose ?

Non. Trouver, installer et exécuter une compétence est gratuit. Seuls les images, clips vidéo, musiques et voix off produits via PopNow sont facturés : les appels avec clé API dépensent des USD API ; MCP par OAuth dépense les crédits du site, au même tarif de modèle. La compétence annonce chaque prix et attend votre accord.

Combien de compétences puis-je obtenir ?

Les comptes gratuits peuvent ajouter 5 nouvelles compétences par jour et 20 au total ; une fois que vous avez acheté des crédits, 30 nouvelles compétences par jour sans total. Télécharger une compétence que vous possédez déjà ne compte jamais. Voir Limites.

Ai-je besoin d’un agent de code ?

Pour les sites, les diaporamas et les vidéos rendues, oui : la compétence exécute des scripts et construit des fichiers sur votre machine. Les compétences d’image fonctionnent aussi dans ChatGPT ou Claude.ai une fois PopNow connecté via MCP, car les images sont créées avec create_image directement dans la conversation.

Ai-je besoin d’une clé API ?

Pas via MCP : la connexion est déjà authentifiée, use_skill fournit un lien de téléchargement, et les médias passent par les outils PopNow. Pour l’API REST, curl installe, et le script d’aide de la compétence demande POPNOW_API_KEY défini avec une clé créée dans la console API.

Puis-je partager une compétence ou la mettre dans mon dépôt ?

Utilisez les compétences pour votre propre travail et pour vos clients, et gardez ce que vous produisez avec elles. Ne publiez pas, ne revendez pas et ne redistribuez pas les paquets eux-mêmes ; envoyez plutôt à vos coéquipiers la page de la compétence pour qu’ils installent leur propre copie. Chaque paquet téléchargé porte un identifiant de licence pour le compte qui l’a téléchargé.

En quoi est-ce différent de popnow-skills sur GitHub ?

popnow-skills est un ensemble open source qui apprend aux agents à appeler l’API PopNow en général. Les compétences d’agent sont des styles finis, chacun pour un type de résultat, avec des aperçus, choisis dans le catalogue sur popnow.ai. Voir SDK, CLI et outils open source.

Liens connexes