代理技能
為產品發表影片、投影片、網站或編輯風格圖片找到現成的風格,交給你的程式代理。可以在對話中透過 MCP 選擇,也可以用安裝提示詞、ZIP 或 curl 裝進 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 或 OpenCode。
代理技能是一份操作手冊,教 AI 程式代理用一種具名的完整風格、做出某一類作品:例如用 HTML 算繪的產品發表影片、投影片、到達頁面或整個網站、一組編輯風格的圖片。每個技能是一個資料夾 popnow-<slug>/,裡面有代理會讀取的 SKILL.md,以及它需要的腳本、參考檔案和素材。
技能免費。透過 API 金鑰生成的素材(包括技能的 REST 輔助程式或 API-key MCP)使用獨立的 API 美元餘額;透過 OAuth MCP 生成的素材使用網站點數。API 美元餘額初始為 $0,請在 API 帳單儲值。網站點數與 API 資金不能互轉,也不能相互抵用。技能需要圖片、影片、音樂或配音時,會透過 PopNow 按 API 計費中的正常模型價格生成,開始前一定先告訴你價格。所有技能及預覽都在 popnow.ai/skills/agent-skills。
有兩種使用方式:
- 在對話中使用(推薦)。 把 PopNow 作為 MCP 伺服器接入後,說出你想做什麼。助手會展示幾種帶預覽的風格,你選定一個,PopNow 就把這個技能交給助手去執行。
- 自己安裝。 把安裝提示詞貼上給你的代理,下載 ZIP,或者用
curl加上你的 API 金鑰取得。
概覽
| 瀏覽 | popnow.ai/skills/agent-skills,可按影片、圖片、投影片或網頁篩選 |
| 在對話中 | 透過 MCP 使用 find_skills(帶預覽的風格)和 use_skill(技能本身、安裝連結,以及如何用 PopNow 生成它所需的媒體) |
| 代理 | Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode |
| 手動安裝 | 安裝提示詞、技能頁面上的 ZIP(需已登入),或用 $POPNOW_API_KEY 執行 curl |
| REST API | GET /api/v1/agent-skills、GET /api/v1/agent-skills/{slug}、GET /api/v1/agent-skills/{slug}/download |
| 價格 | 尋找、安裝和使用免費。技能生成的圖片、影片、音樂和配音按生成計費,開始前先報價 |
| 數量 | 免費帳號:每 24 小時可新增 5 個技能,總計 20 個。購買過任意點數後:每 24 小時可新增 30 個,沒有總量上限。已經新增過的技能不會再次計數。見限制 |
| 授權 | 供你自己的工作和客戶的工作使用。請勿發布或再分發套件 |
在對話中選擇技能
只需連線一次 PopNow(Claude、ChatGPT、Claude Code、Cursor 等),然後說出你想要的結果。助手會使用兩個免費工具:
find_skills從目錄中尋找符合你需求的技能,回傳最多四種風格,最符合需求的在前。每種風格附帶一句話的外觀描述、最適合的用途、預覽影片和封面圖、它能透過 PopNow 生成哪些媒體、它在你的電腦上需要什麼(Node.js、Python 3、FFmpeg、Chrome),以及它的頁面。- 你來選擇一個。
use_skill回傳該技能完整的操作手冊(SKILL.md)、幾分鐘內有效的整包下載連結、把它裝進你的代理技能資料夾的確切命令,以及如何在同一連線中用 PopNow 工具生成它的圖片、影片、音樂和語音。
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)| 工具 | 回傳什麼 | 參數 |
|---|---|---|
find_skills | 最多 limit 個風格,最符合需求的在前:slug、名稱、外觀、最適合的用途、預覽影片、封面圖、PopNow 媒體、本機條件、頁面 | intent(必填,用你自己的話描述想做什麼)、type(video、image、slides 或 web)、limit(1–6,預設 4) |
use_skill | 操作手冊(SKILL.md)、整包的簽名下載連結、你的代理的安裝命令,以及其媒體對應的 PopNow 工具 | slug(必填,來自 find_skills)、agent(claude-code、codex、cursor、gemini-cli、github-copilot、opencode 或 chat) |
- 透過 PopNow 生成媒體。 技能附帶一個用於 REST API 的小型輔助腳本。透過 MCP 不需要 API 金鑰:只要操作手冊要呼叫該腳本,助手就改用
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或anime_to_real。每一個都會先報價,超過自動確認上限的部分要等你同意,見 MCP 的價格與確認。 - 用哪個代理。 不填
agent時,PopNow 會根據你連線時使用的應用來猜。在 ChatGPT 或 Claude.ai(agent: "chat")中沒有檔案系統:圖片類技能仍可透過create_image在那裡使用,而網站、投影片和算繪好的影片需要程式代理;助手可以和你一起規劃並製作媒體,並給你一個之後可用的下載連結。 - 限額。
find_skills每個帳號每小時 240 次,use_skill每小時 120 次。兩者都免費且唯讀。透過use_skill選中的新技能,和下載一樣計入你的技能上限;使用你已經有的技能則永遠不計入。
自己安裝
用安裝提示詞
每個技能頁面都有 Copy install 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.下載 ZIP
在 popnow.ai 上登入後,技能頁面上的 Download ZIP 會儲存 popnow-<slug>.zip。把它解壓到下面列出的某個資料夾中。
用 curl
在 API 控制台建立一個金鑰,把它匯出為 POPNOW_API_KEY,然後執行:
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壓縮檔裡只有一個資料夾 popnow-<slug>/,裡面是 SKILL.md。有些代理只在新工作階段中載入新技能。
| 代理 | 個人資料夾 | 專案資料夾 | 呼叫方式 |
|---|---|---|---|
| Claude Code | ~/.claude/skills | .claude/skills | /popnow-<slug> |
| Codex | ~/.agents/skills | .agents/skills | $popnow-<slug> |
| Cursor | ~/.cursor/skills | .cursor/skills | /popnow-<slug> |
| Gemini CLI | ~/.gemini/skills | .gemini/skills | popnow-<slug> |
| GitHub Copilot | ~/.copilot/skills | .github/skills | /popnow-<slug> |
| OpenCode | ~/.config/opencode/skills | .opencode/skills | popnow-<slug> |
個人資料夾會讓技能在每個專案中都可用;專案資料夾則只在該程式碼儲存庫中可用。
限制
技能免費,但每個帳戶能新增的不同技能數量有上限。下列網站點數購買條件僅用於判斷技能下載資格,不是 API 儲值條件,也不代表網站點數能用於 API 呼叫。網站上的 Download ZIP、下載端點和 MCP 的 use_skill 共用這個限額。
| 帳號 | 任意 24 小時內新增的技能 | 總計 |
|---|---|---|
| 免費(從未購買過點數) | 5 | 20 |
| 購買過至少一次點數(價格) | 30 | 無上限 |
- 重新下載不受限制。 你已經新增過的技能,可以隨時重新下載、重新安裝,或用
use_skill再次選擇,在任何裝置上都行,並且永遠不會再次計數。 - 24 小時滾動計算。 每個新技能會在你新增後 24 小時釋放一個名額。達到上限時,提示會告訴你下一個名額何時開放。
- 你的副本歸你所有。 你下載的每個套件都帶有屬於你帳號的授權 ID(寫在
LICENSE.txt和popnow-<slug>/.popnow-license.json中)。它不會改變技能的工作方式,只是用來區分你的正版副本和外流的副本,所以請不要發布這些套件。
超過上限時,下載端點回傳 429,業務碼為 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 時,附帶以秒計的 retryAfter、resetAt 和 Retry-After 回應標頭;為 lifetime 時,表示免費帳號的 20 個總量已滿,等待不會恢復名額。透過 MCP 使用時,use_skill 會以易懂的方式說明原因,而不是回傳技能。
REST API
這三個端點都用你的 API 金鑰作為 Bearer 權杖。它們回傳目錄和安裝步驟;操作手冊本身隨套件一起提供(或者透過 MCP 的 use_skill 取得)。
列出與搜尋
curl "https://api.popnow.ai/api/v1/agent-skills?type=slides&q=pitch%20deck" \
-H "Authorization: Bearer $POPNOW_API_KEY"所有篩選條件都是可選的。type 可以是 video、image、slides 或 web;task 保留帶有某個任務標籤的技能(例如 landing-page 或 pitch-deck);q 按自由文字的相關度排序,並去掉任何詞都不符合的技能。不加篩選條件時,回傳整個目錄,最符合需求的在前。
{
"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 列出該技能可以透過 PopNow 生成的媒體;當技能缺少這些媒體就無法完成時,popnowRequired 為 true。requires 列出它要在你的電腦上執行的工具。
單一技能及其安裝步驟
curl https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page \
-H "Authorization: Bearer $POPNOW_API_KEY"回傳結果包含相同的欄位,外加 install:套件內的資料夾名、下載路徑、安裝提示詞、安裝指南,以及每個代理一條紀錄,內含它的資料夾、呼叫方式,以及一條可直接執行的個人資料夾安裝命令。
{
"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"
},
...
]
}
}
}要只為某一個程式碼儲存庫安裝,把命令中的 personalDir 換成 projectDir 即可。
下載
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該端點回傳 302,指向 ZIP 的簽名連結,幾分鐘後失效。所以務必跟隨重新導向(-L),並且永遠不要儲存這個連結。
錯誤與限制
| 狀態碼 | 出現時機 |
|---|---|
400 | type 不是 video、image、slides 或 web,或者 q 超過 200 個字元 |
401 | 缺少 API 金鑰,或金鑰錯誤 |
403 | 該帳號已關閉技能下載;請發郵件到 support@popnow.ai |
404 | 沒有該 slug 對應的技能 |
429 | 請求過多(每個帳號每分鐘 60 次目錄請求或 30 次下載),或者業務碼為 42901、data.reason 為 skill_quota 時,即觸發了技能上限 |
503 | 下載暫時不可用;一分鐘後再試 |
代理技能要花錢嗎?
不必。尋找、安裝和執行技能都是免費的。只有技能透過 PopNow 生成的圖片、影片、音樂和配音才收費:API 金鑰呼叫使用 API 美元餘額,OAuth MCP 使用網站點數,按相同模型價格計費。每次生成都會先報價,等你確認後再執行。
我能獲得多少個技能?
免費帳號每天可以新增 5 個技能,總計 20 個;購買過點數後,每天可以新增 30 個,沒有總量上限。下載你已經有的技能永遠不計數。見限制。
我需要程式代理嗎?
做網站、投影片和算繪影片時需要:技能要在你的電腦上執行腳本並生成檔案。圖片類技能在 PopNow 透過 MCP 接入 ChatGPT 或 Claude.ai 後也能用,因為圖片直接在對話中用 create_image 生成。
我需要 API 金鑰嗎?
透過 MCP 不需要:連線本身已經登入,use_skill 會提供下載連結,媒體透過 PopNow 工具生成。使用 REST API、透過 curl 安裝或使用技能自帶的輔助腳本時,請把 POPNOW_API_KEY 設為 API 控制台中的一個金鑰。
我可以分享技能或把它放進我的程式碼儲存庫嗎?
請將技能用於你自己的工作和客戶的工作,並保留你用它做出的成果。不要發布、轉售或再分發套件本身;把技能頁面發給同事,讓他們安裝自己的副本。每個下載的套件都帶有下載它的帳號的授權 ID。
它和 GitHub 上的 popnow-skills 有什麼不同?
popnow-skills 是一套開源技能,教代理通用地呼叫 PopNow API。代理技能則是成品風格,每種都針對一類結果,附帶預覽,從 popnow.ai 上的目錄中挑選。見 SDK、CLI 與開源工具。

