エージェントスキル
製品発表の動画、スライドデッキ、Web サイト、編集用の画像に使える完成したスタイルを探し、コーディングエージェントに渡します。MCP 経由のチャットで選ぶか、プロンプト、ZIP、curl を使って Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode に入れられます。
エージェントスキルは、AI のコーディングエージェントに、ひとつの種類のものを、完成した名前付きのスタイルで作らせるための手順書です。例: HTML から描画する製品発表の動画、スライドデッキ、ランディングページや Web サイト全体、編集用の画像セット。スキルはそれぞれ popnow-<slug>/ というフォルダで、エージェントが読む SKILL.md に加え、必要なスクリプト、参照ファイル、素材が入っています。
スキルは無料です。スキルの REST 補助スクリプトや API キーの MCP を含む、API キーでのメディア生成は独立した API の USD 残高を使います。OAuth MCP のメディア生成はウェブサイトのクレジットを使います。API USD の初期残高は $0 で、API billing で入金します。ウェブサイトのクレジットと API 資金は相互に移行できず、代わりに使うこともできません。画像、動画クリップ、音楽、ナレーションが必要なときは、API の課金にある通常のモデル料金で PopNow を通して作り、実行前に必ず料金を伝えます。プレビュー付きの全スキルは popnow.ai/skills/agent-skills で確認できます。
利用方法は 2 つあります。
- チャットから(おすすめ)。 PopNow を MCP サーバーとして接続したうえで、作りたいものを伝えます。アシスタントがプレビュー付きでいくつかのスタイルを見せ、あなたが 1 つ選ぶと、PopNow がそのスキルをアシスタントに渡して実行させます。
- 自分でインストールする。 エージェントにインストール用のプロンプトを貼り付けるか、ZIP をダウンロードするか、API キーを使って
curlで取得します。
概要
| 参照 | popnow.ai/skills/agent-skills。動画、画像、スライド、Web で絞り込み |
| チャットで | 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 |
| 料金 | 探す、インストールする、使うのは無料。スキルが作る画像、動画、音楽、音声は生成料金がかかり、先に見積もりを出します |
| 追加できる数 | 無料アカウント: 1 日あたり新規 5 件、累計 20 件。クレジットを一度でも購入すると: 1 日あたり新規 30 件、累計の上限なし。すでに追加したスキルは再び数えられません。上限を参照 |
| ライセンス | ご自身の作業と、クライアントの作業のため。パッケージを公開・再配布しないでください |
チャットでスキルを選ぶ
PopNow は一度接続しておきます(Claude、ChatGPT、Claude Code、Cursor など)。そのうえで、ほしい結果を頼みます。アシスタントは 2 つの無料ツールを使います。
find_skillsが依頼の内容をカタログと照合し、最大 4 件のスタイルを良い順に返します。各スタイルには、見た目の一行説明、向いている用途、プレビュー動画とカバー画像、PopNow で作れるメディア、お使いのマシンに必要なもの(Node.js、Python 3、FFmpeg、Chrome)、そのページが付いています。- あなたが 1 つ選びます。
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のいずれかを使います。どれも先に見積もりを出し、自動確認の上限を超えるものは、料金と確認で説明しているとおり、あなたが承諾するまで待ちます。 - どのエージェントか。
agentを省くと、PopNow は接続に使ったアプリから推測します。ChatGPT や Claude.ai(agent: "chat")にはファイルシステムがありません。画像のスキルはcreate_imageを通じてそこでも動きます。一方、Web サイト、スライド、描画した動画にはコーディングエージェントが必要です。アシスタントはあなたと計画を立てて、メディアを作り、後で使えるようダウンロードリンクを渡します。 - 上限。
find_skillsは 1 アカウントあたり 1 時間に 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 として export してから、次を実行します。
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>/ という 1 つのフォルダが入っており、その中に 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> |
個人用フォルダに置くと、どのプロジェクトでもスキルが使えます。プロジェクト用フォルダに置くと、そのリポジトリでだけ使えます。
上限
スキルは無料ですが、1 つのアカウントが追加できる異なるスキルの数に上限があります。ウェブサイトの Download ZIP、ダウンロードのエンドポイント、MCP の use_skill はすべてこの上限を共有します。 以下のウェブサイトのクレジット購入条件はスキルのダウンロード資格についてのもので、API 入金ではありません。ウェブサイトのクレジットが API に使えるようになるわけではありません。
| アカウント | 24 時間以内の新規スキル | 累計 |
|---|---|---|
| 無料(一度もクレジットを購入していない) | 5 | 20 |
| クレジットを一度でも購入(料金) | 30 | 上限なし |
- 再ダウンロードは無料です。 追加済みのスキルは、いつでも、どの端末でも、再ダウンロード、再インストール、
use_skillでの再選択ができ、二度と数えられません。 - 24 時間は連続して数えます。 新しく追加したスキルは、追加から 24 時間後に枠が空きます。上限に達すると、次に枠が空くのがいつかをメッセージで伝えます。
- あなたのコピーはあなたのものです。 ダウンロードした各パッケージには、あなたのアカウントのライセンス ID が入っています(
LICENSE.txtとpopnow-<slug>/.popnow-license.json)。スキルの動作は変わりません。正規のライセンスのコピーと流出したコピーを見分けるためのものなので、パッケージは公開しないでください。
上限を超えると、ダウンロードのエンドポイントは業務コード 42901 とともに 429 を返します。
{
"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
3 つのエンドポイントはすべて、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 は、1 つのタスクにタグ付けされたスキルに絞ります(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 は、お使いのマシン上で動かすツールを並べたものです。
1 つのスキルとインストール手順
curl https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page \
-H "Authorization: Bearer $POPNOW_API_KEY"レスポンスは同じフィールドに加えて install を含みます。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"
},
...
]
}
}
}1 つのリポジトリだけにインストールする場合は、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エンドポイントは、ZIP への署名付きリンクを 302 で返します。このリンクは数分で期限切れになるため、必ずリダイレクトに従い(-L)、リンクは保存しないでください。
エラーと上限
| ステータス | 発生するとき |
|---|---|
400 | type が video、image、slides、web のいずれでもない、または q が 200 文字を超える |
401 | API キーがない、または間違っている |
403 | このアカウントではスキルのダウンロードが無効になっている。support@popnow.ai まで連絡してください |
404 | その slug のスキルが存在しない |
429 | リクエストが多すぎる(アカウントごとに 1 分あたりカタログ 60 回、ダウンロード 30 回まで)。または、コード 42901 と data.reason の skill_quota が付いたスキルの上限 |
503 | ダウンロードが一時的に使えない。1 分ほどしてから再試行してください |
スキルには料金がかかりますか?
いいえ。スキルの検索、インストール、実行は無料です。料金がかかるのは PopNow で作る画像、動画クリップ、音楽、ナレーションだけです。API キーは API USD、OAuth MCP はウェブサイトのクレジットを使い、同じモデルの料金基準が適用されます。スキルは一つずつ見積もりを出し、あなたの承諾を待ちます。
スキルは何件まで追加できますか?
無料アカウントは 1 日に新規 5 件、累計 20 件まで追加できます。クレジットを一度購入すると、1 日に新規 30 件まで、累計の上限はなくなります。すでに持っているスキルのダウンロードは数えられません。上限を参照してください。
コーディングエージェントが必要ですか?
Web サイト、スライド、描画した動画には必要です。スキルはお使いのマシンでスクリプトを動かし、ファイルを作るためです。画像のスキルは、PopNow を MCP で接続すれば ChatGPT や Claude.ai でも使えます。画像は create_image を使ってチャットの中で作られるためです。
API キーは必要ですか?
MCP では必要ありません。接続はすでにサインインされており、use_skill がダウンロードリンクを返し、メディアは PopNow のツールを通ります。REST API では、curl によるインストールとスキル付属の補助スクリプトのために、API コンソールで作ったキーを POPNOW_API_KEY に設定してください。
スキルを共有したり、リポジトリに入れたりできますか?
スキルはご自身の作業とクライアントの作業のために使い、そこで作ったものはそのまま保管してください。パッケージそのものは公開、転売、再配布しないでください。チームメンバーには、スキルのページを送り、各自のコピーをインストールしてもらってください。ダウンロードされたパッケージには、ダウンロードしたアカウントのライセンス ID が入っています。
これは GitHub の popnow-skills とどう違いますか?
popnow-skills は、エージェントに PopNow API を呼び出すことを一般的に教えるオープンソースのセットです。エージェントスキルは、結果の種類ごとに完成したスタイルで、プレビュー付きで popnow.ai のカタログから選びます。SDK、CLI、オープンソースツールを参照してください。

