Agent skills

Una agent skill è un playbook che insegna a un agente di coding IA a costruire un tipo di cosa in un solo stile finito e con nome: un video di lancio di un prodotto generato da HTML, una presentazione, una landing page o un intero sito, una serie di immagini editoriali. Ogni skill è una cartella, popnow-<slug>/, con un SKILL.md che l’agente legge, più gli script, i file di riferimento e le risorse di cui ha bisogno.

Le skill sono gratuite. I media creati con una chiave API, anche tramite lo script REST della skill o MCP con chiave API, consumano il saldo API separato in USD. I media creati tramite MCP con OAuth usano i crediti del sito. Il saldo API parte da $0; aggiungi fondi in Fatturazione API. I due saldi non si possono trasferire né usare l’uno al posto dell’altro. Quando una skill ha bisogno di un’immagine, di una clip video, di musica o di una voce narrante, la produce tramite PopNow ai normali prezzi dei modelli descritti in Fatturazione API, e ti dice sempre il prezzo prima di spendere qualsiasi cosa. Sfoglia tutte le skill con le anteprime su popnow.ai/skills/agent-skills.

Ci sono due modi per iniziare:

• Da una chat (consigliato). Con PopNow collegato come server MCP, descrivi ciò che vuoi creare. L’assistente mostra alcuni stili con le anteprime, tu ne scegli uno e PopNow consegna quella skill all’assistente perché la realizzi.
• Installala da solo. Incolla un prompt di installazione nel tuo agente, scarica lo ZIP oppure recuperalo con curl e la tua chiave API.

Vista d’insieme

Scegli una skill in chat

Collega PopNow una volta (Claude, ChatGPT, Claude Code, Cursor e altri) e chiedi il risultato che vuoi. L’assistente usa due strumenti gratuiti:

1. find_skills confronta ciò che hai chiesto con il catalogo e restituisce fino a quattro stili, il migliore per primo, ciascuno con una breve descrizione dell’aspetto, a cosa serve meglio, un video e un’immagine di anteprima, quali media può produrre con PopNow, cosa richiede sul tuo computer (Node.js, Python 3, FFmpeg, Chrome) e la sua pagina.
2. Ne scegli una.
3. use_skill restituisce il playbook completo di quella skill (SKILL.md), un link di download dell’intero pacchetto valido per alcuni minuti, i comandi esatti per installarla nella cartella delle skill del tuo agente, e come produrre le sue immagini, il suo video, la sua musica e la sua voce con gli strumenti PopNow nella stessa connessione.

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)

• Media tramite PopNow. Le skill includono un piccolo script di supporto per la REST API. Tramite MCP non serve nessuna chiave API: dove il playbook chiama lo script, l’assistente usa invece 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. Ognuno mostra prima il prezzo, e ciò che supera il tuo limite di conferma automatica attende il tuo sì, come descritto in Prezzi e conferma.
• Quale agente. Se ometti agent, PopNow indovina dall’app con cui ti sei collegato. In ChatGPT o Claude.ai (agent: "chat") non c’è un file system: le skill di immagini funzionano comunque tramite create_image, mentre siti, presentazioni e video renderizzati richiedono un agente di coding; l’assistente può pianificare con te e produrre i media, e ti dà il link di download per dopo.
• Limiti. find_skills 240 e use_skill 120 chiamate per account all’ora. Entrambi sono gratuiti e in sola lettura. Una nuova skill scelta con use_skill conta verso il tuo limite di skill come un download; usarne una che hai già non conta mai.

Installala da solo

Con un prompt

Ogni pagina di skill ha Copy install prompt. Incollalo nel tuo agente: l’agente legge la guida all’installazione, sceglie la sua cartella delle skill e scarica il pacchetto con la tua chiave:

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.

Scarica lo ZIP

Con l’accesso su popnow.ai, Download ZIP nella pagina della skill salva popnow-<slug>.zip. Decomprimilo in una delle cartelle qui sotto.

Con curl

Crea una chiave nella console API, esportala come POPNOW_API_KEY, poi:

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’archivio contiene una sola cartella, popnow-<slug>/, con dentro SKILL.md. Alcuni agenti caricano le nuove skill solo in una nuova sessione.

La cartella personale rende la skill disponibile in ogni progetto; la cartella del progetto solo in quel repository.

Limiti

Le skill sono gratuite, con un tetto su quante diverse skill un account può aggiungere. I criteri di acquisto dei crediti del sito sotto determinano l’idoneità al download delle skill, non le ricariche API; non rendono i crediti del sito utilizzabili per le chiamate API. Il Download ZIP del sito, l’endpoint di download e use_skill tramite MCP condividono tutti lo stesso tetto.

• Riscaricare è gratis. Una skill che hai già aggiunto può essere scaricata, reinstallata o scelta di nuovo con use_skill in qualsiasi momento, su qualsiasi dispositivo, e non conta mai più.
• Le 24 ore scorrono. Ogni nuova skill libera uno slot 24 ore dopo che l’hai aggiunta. Quando raggiungi il tetto, il messaggio indica quando si apre lo slot successivo.
• La tua copia è tua. Ogni pacchetto scaricato porta un ID di licenza per il tuo account (in LICENSE.txt e in popnow-<slug>/.popnow-license.json). Non cambia il funzionamento della skill; serve a distinguere la tua copia con licenza da una copia trafugata, quindi non pubblicare i pacchetti.

Oltre il tetto, l’endpoint di download risponde 429 con il codice di business 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 (con retryAfter in secondi, resetAt e un header Retry-After) oppure lifetime (il totale di 20 skill per gli account gratuiti; non c’è da aspettare). Tramite MCP, use_skill dice la stessa cosa con parole semplici invece di restituire la skill.

REST API

Tutti e tre gli endpoint accettano la tua chiave API come Bearer token. Restituiscono il catalogo e i passaggi di installazione; il playbook arriva con il pacchetto (o tramite use_skill in MCP).

Elenca e cerca

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

Ogni filtro è facoltativo. type è video, image, slides o web; task mantiene le skill con un’attività specifica (come landing-page o pitch-deck); q ordina per pertinenza rispetto al testo libero ed esclude le skill che non contengono nessuna delle sue parole. Senza filtri ottieni l’intero catalogo, il migliore per primo.

{
  "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 elenca i media che la skill può produrre tramite PopNow; popnowRequired è true quando la skill non può finire senza di essi. requires elenca gli strumenti che esegue sul tuo computer.

Una skill con i passaggi di installazione

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

La risposta ha gli stessi campi più install: il nome della cartella dentro il pacchetto, il percorso di download, il prompt di installazione, la guida all’installazione e una voce per ogni agente, con le sue cartelle, come richiamare la skill e un comando pronto da eseguire per la cartella personale.

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

Per installare solo per un repository, esegui il comando con projectDir al posto di personalDir.

Scarica

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 risponde 302 con un link firmato allo ZIP che scade dopo alcuni minuti: segui sempre il reindirizzamento (-L) e non salvare mai il link.

Errori e limiti

Le agent skills costano qualcosa?

No. Trovare, installare ed eseguire una skill è gratuito. Si pagano solo le immagini, le clip video, la musica e le voci narranti che una skill produce tramite PopNow: le chiamate con chiave API usano gli USD API, MCP via OAuth usa i crediti del sito, allo stesso prezzo del modello. La skill mostra il prezzo di ciascuno e attende il tuo sì.

Quante skill posso ottenere?

Gli account gratuiti possono aggiungere 5 nuove skill al giorno e 20 in totale; dopo aver acquistato crediti, 30 nuove skill al giorno senza limite totale. Scaricare una skill che hai già non conta mai. Vedi Limiti.

Mi serve un agente di coding?

Per siti, presentazioni e video renderizzati, sì: la skill esegue script e costruisce file sul tuo computer. Le skill di immagini funzionano anche in ChatGPT o Claude.ai una volta collegato PopNow tramite MCP, perché le immagini vengono create con create_image direttamente in chat.

Mi serve una chiave API?

Non tramite MCP: la connessione è già autenticata, use_skill fornisce un link di download e i media passano dagli strumenti PopNow. Per la REST API, le installazioni con curl e lo script di supporto della skill richiedono di impostare POPNOW_API_KEY con una chiave della console API.

Posso condividere una skill o metterla nel mio repository?

Usa le skill per il tuo lavoro e per quello dei tuoi clienti, e tieni ciò che costruisci con esse. Non pubblicare, rivendere né ridistribuire i pacchetti in sé; manda ai colleghi la pagina della skill, così installano la propria copia. Ogni pacchetto scaricato porta un ID di licenza dell’account che l’ha scaricato.

In cosa si differenzia da popnow-skills su GitHub?

popnow-skills è un insieme open source che insegna agli agenti a chiamare in generale la API di PopNow. Le agent skills sono stili finiti, ciascuno per un tipo di risultato, con anteprime, scelti dal catalogo su popnow.ai. Vedi SDK, CLI e strumenti open source.

Correlati