Agent Skills

Agent skill to scenariusz działania, który uczy agenta AI kodującego budować jeden rodzaj rzeczy w jednym gotowym, nazwanym stylu: film o premierze produktu renderowany z HTML, prezentację, stronę docelową albo całą witrynę, zestaw obrazów redakcyjnych. Każdy skill to folder popnow-<slug>/ z plikiem SKILL.md, który agent czyta, oraz skryptami, plikami referencyjnymi i zasobami, których potrzebuje.

Skille są bezpłatne. Media tworzone z kluczem API, także przez skrypt pomocniczy REST skilla lub MCP z kluczem API, zużywają osobne saldo API w USD. Media z MCP przez OAuth zużywają kredyty strony. Saldo API zaczyna się od 0 USD; doładuj je w rozliczeniach API. Kredytów strony i środków API nie można między sobą przenosić ani używać zamiennie. Gdy skill potrzebuje zdjęcia, klipu wideo, muzyki albo lektora, wykonuje je przez PopNow po zwykłych cenach modeli opisanych w rozliczeniach API i zawsze mówi, ile to kosztuje, zanim cokolwiek zostanie wydane. Przejrzyj wszystkie skille z podglądami pod adresem popnow.ai/skills/agent-skills.

Są dwa sposoby, żeby zacząć:

• Z czatu (zalecane). Gdy PopNow jest połączone jako serwer MCP, powiedz, co chcesz stworzyć. Asystent pokaże kilka stylów z podglądami, wybierasz jeden, a PopNow przekazuje ten skill asystentowi do wykonania.
• Zainstaluj samodzielnie. Wklej prompt instalacyjny do swojego agenta, pobierz plik ZIP albo pobierz paczkę przez curl z kluczem API.

Najważniejsze informacje

Wybierz skill w czacie

Połącz PopNow raz (Claude, ChatGPT, Claude Code, Cursor i inne) i poproś o wynik, którego potrzebujesz. Asystent korzysta z dwóch darmowych narzędzi:

1. find_skills dopasowuje to, o co prosisz, do katalogu i zwraca najwyżej cztery style, od najlepszego. Każdy ma jednozdaniowy opis wyglądu, to, do czego najlepiej pasuje, podgląd wideo i obraz okładki, informację, jakie media może wykonać przez PopNow, czego potrzebuje na twoim komputerze (Node.js, Python 3, FFmpeg, Chrome) oraz swoją stronę.
2. Wybierasz jeden.
3. use_skill zwraca pełny scenariusz tego skilla (SKILL.md), link do pobrania całej paczki (działa przez kilka minut), dokładne polecenia instalacji w folderze skilli twojego agenta oraz to, jak wykonać jego obrazy, wideo, muzykę i głos narzędziami PopNow w tym samym połączeniu.

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 przez PopNow. Skille zawierają mały skrypt pomocniczy do REST API. Przez MCP klucz API nie jest potrzebny: wszędzie, gdzie scenariusz wywołuje skrypt, asystent używa 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, lub anime_to_real. Każde z nich podaje cenę z góry, a wszystko, co przekracza twój próg automatycznego potwierdzania, czeka na twoją zgodę, jak opisano w Ceny i potwierdzenie.
• Który agent. Jeśli pominiesz agent, PopNow zgaduje na podstawie aplikacji, którą połączyłeś. W ChatGPT albo Claude.ai (agent: "chat") nie ma systemu plików: skille obrazów nadal działają tam przez create_image, a witryny, prezentacje i wyrenderowane wideo wymagają agenta kodującego. Asystent może zaplanować z tobą i wykonać media, a link do pobrania dostajesz na później.
• Limity. find_skills 240, a use_skill 120 wywołań na konto na godzinę. Oba są bezpłatne i tylko do odczytu. Nowy skill wybrany przez use_skill liczy się do twojego limitu skilli tak jak pobranie; użycie skilla, który już masz, nigdy się nie liczy.

Zainstaluj samodzielnie

Z promptem

Na każdej stronie skilla jest przycisk Copy install prompt. Wklej go do agenta; ten przeczyta przewodnik instalacji, sam wybierze folder skilli i pobierze paczkę z twoim kluczem:

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.

Pobierz plik ZIP

Po zalogowaniu na popnow.ai przycisk Download ZIP na stronie skilla zapisuje plik popnow-<slug>.zip. Rozpakuj go w jednym z poniższych folderów.

Z curl

Utwórz klucz w konsoli API, wyeksportuj go jako POPNOW_API_KEY, a potem:

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

Archiwum zawiera jeden folder, popnow-<slug>/, a w nim SKILL.md. Niektórzy agenci ładują nowe skille dopiero w nowej sesji.

Folder osobisty udostępnia skill we wszystkich projektach; folder projektu tylko w tym jednym repozytorium.

Limity

Skille są bezpłatne, z limitem, ile różnych skilli jedno konto może dodać. Poniższe kryteria zakupu kredytów strony dotyczą uprawnień do pobierania skilli, a nie doładowania API; nie pozwalają płacić kredytami strony za wywołania API. Przycisk Download ZIP na stronie, endpoint pobierania i use_skill przez MCP korzystają z tego samego limitu.

• Ponowne pobranie jest bezpłatne. Skill, który już dodałeś, można pobrać, zainstalować ponownie albo wybrać przez use_skill w dowolnym momencie, na dowolnym urządzeniu, i nigdy nie liczy się ponownie.
• 24 godziny toczą się. Każdy nowy skill zwalnia miejsce 24 godziny po dodaniu. Gdy osiągniesz limit, komunikat podaje, kiedy otworzy się kolejne miejsce.
• Twoja kopia jest twoja. Każda pobrana paczka zawiera identyfikator licencji dla twojego konta (w LICENSE.txt i popnow-<slug>/.popnow-license.json). Nie zmienia to działania skilla; służy do odróżnienia twojej licencjonowanej kopii od wyciekłej, więc nie publikuj paczek.

Po przekroczeniu limitu endpoint pobierania odpowiada 429 z kodem biznesowym 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 ma wartość daily (z retryAfter w sekundach, resetAt i nagłówkiem Retry-After) albo lifetime (łączny limit 20 skilli dla kont bezpłatnych; nie ma czego czekać). Przez MCP use_skill mówi to samo zwykłymi słowami zamiast zwracać skill.

REST API

Wszystkie trzy endpointy przyjmują klucz API jako token Bearer. Zwracają katalog i kroki instalacji; sam scenariusz przychodzi razem z paczką (albo przez use_skill w MCP).

Lista i wyszukiwanie

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

Każdy filtr jest opcjonalny. type to video, image, slides albo web; task zachowuje skille oznaczone jednym zadaniem (np. landing-page albo pitch-deck); q sortuje według trafności względem wolnego tekstu i pomija skille, które nie pasują do żadnego jego słowa. Bez filtrów dostajesz cały katalog, od najlepszego.

{
  "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 wymienia media, które skill może wykonać przez PopNow; popnowRequired ma wartość true, gdy skill nie może się dokończyć bez nich. requires wymienia narzędzia, które działają na twoim komputerze.

Jeden skill z krokami instalacji

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

Odpowiedź ma te same pola plus install: nazwę folderu w paczce, ścieżkę pobierania, prompt instalacyjny, przewodnik instalacji oraz jedną pozycję dla każdego agenta, z jego folderami, sposobem wywołania skilla i gotowym do uruchomienia poleceniem dla folderu osobistego.

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

Aby zainstalować tylko dla jednego repozytorium, uruchom polecenie z projectDir zamiast personalDir.

Pobieranie

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

Endpoint odpowiada 302 z podpisanym linkiem do pliku ZIP, który wygasa po kilku minutach, więc zawsze podążaj za przekierowaniem (-L) i nigdy nie zapisuj tego linku.

Błędy i limity

Czy Agent Skills kosztują coś?

Nie. Szukanie, instalowanie i uruchamianie skilla jest bezpłatne. Płacisz tylko za obrazy, klipy wideo, muzykę i nagrania lektorskie tworzone przez PopNow: wywołania z kluczem API zużywają USD z salda API, a MCP przez OAuth — kredyty strony, przy tych samych cenach modeli. Skill podaje cenę każdego elementu i czeka na twoją zgodę.

Ile skilli mogę dostać?

Konta bezpłatne mogą dodać 5 nowych skilli dziennie i 20 łącznie; po zakupie kredytów 30 nowych skilli dziennie bez limitu łącznego. Pobranie skilla, który już masz, nigdy się nie liczy. Zobacz Limity.

Czy potrzebuję agenta kodującego?

W przypadku witryn, prezentacji i wyrenderowanych wideo tak: skill uruchamia skrypty i buduje pliki na twoim komputerze. Skille obrazów działają też w ChatGPT albo Claude.ai, gdy PopNow jest połączone przez MCP, bo obrazy powstają przez create_image bezpośrednio w czacie.

Czy potrzebuję klucza API?

Przez MCP nie: połączenie jest już zalogowane, use_skill daje link do pobrania, a media idą przez narzędzia PopNow. W przypadku REST API instalacja przez curl i skrypt pomocniczy skilla wymagają ustawienia POPNOW_API_KEY na klucz z konsoli API.

Czy mogę udostępnić skill albo umieścić go w moim repozytorium?

Używaj skilli do własnej pracy i pracy dla klientów oraz zachowuj to, co dzięki nim zbudujesz. Nie publikuj, nie odsprzedawaj ani nie rozpowszechniaj samych paczek; wyślij współpracownikom stronę skilla, aby zainstalowali własną kopię. Każda pobrana paczka zawiera identyfikator licencji konta, które ją pobrało.

Czym to różni się od popnow-skills na GitHubie?

popnow-skills to otwarty zestaw, który uczy agentów wywoływać PopNow API w ogólności. Agent Skills to gotowe style, każdy dla jednego rodzaju wyniku, z podglądami, wybierane z katalogu na popnow.ai. Zobacz SDK, CLI i narzędzia open source.

Powiązane