Agent-Skills

Ein Agent-Skill ist eine Anleitung, die einem KI-Coding-Agenten beibringt, eine Art von Ergebnis in einem fertigen, benannten Stil zu bauen: ein Produkt-Launch-Video, das aus HTML gerendert wird, eine Slide-Deck, eine Landingpage oder eine ganze Website, eine Reihe redaktioneller Bilder. Jeder Skill ist ein Ordner, popnow-<slug>/, mit einer SKILL.md, die der Agent liest, dazu die Skripte, Referenzdateien und Assets, die er braucht.

Skills sind kostenlos. Medien mit API-Schlüssel, auch über das REST-Hilfsskript eines Skills oder API-Key-MCP, verbrauchen dein separates API-USD-Guthaben. OAuth-MCP-Medien verbrauchen Website-Credits. Das API-Guthaben beginnt bei $0; lade unter API-Abrechnung auf. Website-Credits und API-Guthaben lassen sich weder übertragen noch gegenseitig verwenden. Braucht ein Skill ein Bild, einen Videoclip, Musik oder eine Sprachaufnahme, erzeugt er sie über PopNow zu den üblichen Modellpreisen der API-Abrechnung und nennt dir den Preis, bevor etwas ausgegeben wird. Alle Skills mit Vorschauen findest du unter popnow.ai/skills/agent-skills.

Es gibt zwei Wege hinein:

• Aus einem Chat (empfohlen). Mit verbundenem PopNow als MCP-Server sagst du, was du erzeugen willst. Der Assistent zeigt dir ein paar Stile mit Vorschauen, du wählst einen, und PopNow gibt diesen Skill an den Assistenten weiter, der ihn umsetzt.
• Selbst installieren. Füg einen Installations-Prompt in deinen Agenten ein, lade die ZIP-Datei herunter oder hol sie mit curl und deinem API-Schlüssel.

Auf einen Blick

Einen Skill im Chat auswählen

Verbinde PopNow einmal (Claude, ChatGPT, Claude Code, Cursor und andere) und frag nach dem Ergebnis, das du willst. Der Assistent nutzt zwei kostenlose Tools:

1. find_skills gleicht deine Anfrage mit dem Katalog ab und liefert bis zu vier Stile, das beste zuerst. Jeder hat eine Zeile zur Optik, wofür er sich am besten eignet, ein Vorschauvideo und Titelbild, welche Medien er mit PopNow erzeugen kann, was er auf deinem Rechner braucht (Node.js, Python 3, FFmpeg, Chrome) und seine Seite.
2. Du wählst einen aus.
3. use_skill gibt die vollständige Anleitung des Skills (SKILL.md) zurück, einen Download-Link für das ganze Paket, der ein paar Minuten gilt, die genauen Befehle, um den Skill im Skill-Ordner deines Agenten zu installieren, und wie du seine Bilder, Videos, Musik und Stimme mit den PopNow-Tools in derselben Verbindung erzeugst.

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)

• Medien über PopNow. Skills liefern ein kleines Hilfsskript für die REST API mit. Über MCP brauchst du keinen API-Schlüssel: Wo die Anleitung das Skript aufruft, nutzt der Assistent stattdessen 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, oder anime_to_real. Jedes nennt vorab den Preis, und alles über deiner Auto-Bestätigungsgrenze wartet auf dein Ja, wie unter Preise und Bestätigung beschrieben.
• Welcher Agent. Lässt du agent weg, rät PopNow anhand der App, mit der du verbunden bist. In ChatGPT oder Claude.ai (agent: "chat") gibt es kein Dateisystem: Bild-Skills funktionieren dort trotzdem über create_image, während Websites, Decks und gerenderte Videos einen Coding-Agenten brauchen. Der Assistent kann mit dir planen und die Medien erzeugen und dir den Download-Link für später geben.
• Limits. find_skills 240 und use_skill 120 Aufrufe pro Konto und Stunde. Beide sind kostenlos und nur lesend. Ein neuer Skill, den du mit use_skill wählst, zählt wie ein Download auf dein Skill-Limit; einen, den du schon hast, zählt nie.

Selbst installieren

Mit einem Prompt

Jede Skill-Seite hat Copy install prompt. Füg ihn in deinen Agenten ein; der Agent liest die Installationsanleitung, wählt seinen eigenen Skill-Ordner und holt das Paket mit deinem Schlüssel:

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 herunterladen

Angemeldet auf popnow.ai speichert Download ZIP auf der Seite des Skills die Datei popnow-<slug>.zip. Entpack sie in einen der Ordner unten.

Mit curl

Erstell einen Schlüssel in der API-Konsole, exportiere ihn als POPNOW_API_KEY und dann:

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

Das Archiv enthält einen Ordner, popnow-<slug>/, darin SKILL.md. Manche Agenten laden neue Skills erst in einer neuen Sitzung.

Der persönliche Ordner macht den Skill in jedem Projekt verfügbar; der Projektordner nur in diesem einen Repository.

Limits

Skills sind kostenlos, mit einer Obergrenze, wie viele verschiedene Skills ein Konto hinzufügt. Die nachstehenden Kriterien zum Website-Credit-Kauf regeln den Skill-Download, nicht die API-Aufladung; sie machen Website-Credits nicht für API-Aufrufe nutzbar. Download ZIP auf der Website, der Download-Endpunkt und use_skill über MCP teilen sich diese Grenze.

• Erneutes Herunterladen ist kostenlos. Einen Skill, den du schon hinzugefügt hast, kannst du jederzeit, auf jedem Gerät, erneut herunterladen, neu installieren oder mit use_skill wieder wählen. Er zählt nie wieder.
• Die 24 Stunden laufen gleitend. Jeder neue Skill gibt 24 Stunden nach dem Hinzufügen wieder einen Platz frei. Wenn du das Limit erreichst, nennt die Meldung, wann der nächste Platz frei wird.
• Deine Kopie gehört dir. Jedes heruntergeladene Paket trägt eine Lizenz-ID für dein Konto (in LICENSE.txt und popnow-<slug>/.popnow-license.json). Das ändert nichts an der Funktion des Skills; so erkennen wir deine lizenzierte Kopie von einer geleakten. Bitte veröffentliche die Pakete nicht.

Über dem Limit antwortet der Download-Endpunkt mit 429 und dem Geschäftscode 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 ist daily (mit retryAfter in Sekunden, resetAt und einem Retry-After-Header) oder lifetime (das Gesamtlimit von 20 Skills für kostenlose Konten; dort gibt es nichts abzuwarten). Über MCP sagt use_skill dasselbe in einfachen Worten, statt den Skill zurückzugeben.

REST API

Alle drei Endpunkte nehmen deinen API-Schlüssel als Bearer-Token an. Sie liefern den Katalog und die Installationsschritte; die Anleitung selbst kommt mit dem Paket (oder über use_skill über MCP).

Auflisten und suchen

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

Jeder Filter ist optional. type ist video, image, slides oder web; task behält Skills mit einer bestimmten Aufgabe bei (etwa landing-page oder pitch-deck); q sortiert nach Relevanz für freien Text und lässt Skills weg, die keines seiner Wörter treffen. Ohne Filter bekommst du den ganzen Katalog, das beste zuerst.

{
  "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 listet die Medien auf, die der Skill über PopNow erzeugen kann; popnowRequired ist true, wenn der Skill ohne sie nicht fertig werden kann. requires listet die Werkzeuge, die er auf deinem Rechner ausführt.

Ein Skill mit Installationsschritten

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

Die Antwort enthält dieselben Felder plus install: den Ordnernamen im Paket, den Download-Pfad, den Installations-Prompt, die Installationsanleitung und einen Eintrag pro Agent mit seinen Ordnern, wie man den Skill aufruft, und einem fertigen Befehl für den persönlichen Ordner.

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

Um den Skill nur für ein Repository zu installieren, führst du den Befehl mit projectDir statt personalDir aus.

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

Der Endpunkt antwortet mit 302 auf einen signierten Link zur ZIP-Datei, der nach ein paar Minuten abläuft. Folge also immer der Weiterleitung (-L) und speichere den Link nie.

Fehler und Limits

Kosten Agent-Skills etwas?

Nein. Finden, Installieren und Ausführen eines Skills ist kostenlos. Nur seine über PopNow erzeugten Bilder, Videoclips, Musikstücke und Sprachaufnahmen werden berechnet: Aufrufe mit API-Schlüssel verbrauchen API-USD, OAuth-MCP verbraucht Website-Credits, zum selben Modellpreis. Der Skill nennt jeden Preis und wartet auf dein Ja.

Wie viele Skills kann ich bekommen?

Kostenlose Konten können 5 neue Skills pro Tag und 20 insgesamt hinzufügen; sobald du Credits gekauft hast, 30 neue Skills pro Tag ohne Gesamtlimit. Ein erneuter Download eines Skills, den du schon hast, zählt nie. Siehe Limits.

Brauche ich einen Coding-Agenten?

Für Websites, Decks und gerenderte Videos ja: Der Skill führt Skripte aus und baut Dateien auf deinem Rechner. Bild-Skills funktionieren auch in ChatGPT oder Claude.ai, sobald PopNow über MCP verbunden ist, weil die Bilder direkt im Chat mit create_image erzeugt werden.

Brauche ich einen API-Schlüssel?

Über MCP nicht: Die Verbindung ist schon angemeldet, use_skill liefert einen Download-Link, und Medien laufen über die PopNow-Tools. Für die REST API brauchst du curl zum Installieren und das Hilfsskript des Skills; setz POPNOW_API_KEY auf einen Schlüssel aus der API-Konsole.

Kann ich einen Skill teilen oder in mein Repository legen?

Nutz Skills für deine eigene Arbeit und für deine Kunden, und behalt, was du damit baust. Verbreite, verkauf oder gib die Pakete selbst nicht weiter; schick Teamkollegen die Seite des Skills, damit sie ihre eigene Kopie installieren. Jedes heruntergeladene Paket trägt eine Lizenz-ID für das Konto, das es geladen hat.

Worin unterscheidet sich das von popnow-skills auf GitHub?

popnow-skills ist eine Open-Source-Sammlung, die Agenten beibringt, die PopNow API allgemein aufzurufen. Agent-Skills sind fertige Stile für jeweils eine Art von Ergebnis, mit Vorschauen, aus dem Katalog auf popnow.ai ausgewählt. Siehe SDKs, CLI und Open-Source-Tools.

Siehe auch