에이전트 스킬
출시 영상, 슬라이드 덱, 웹사이트, 에디토리얼 이미지에 맞는 완성된 스타일을 찾아 코딩 에이전트에게 넘기세요. 채팅에서 MCP로 고르거나, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode에 프롬프트, ZIP 또는 curl로 설치할 수 있습니다.
에이전트 스킬은 AI 코딩 에이전트에게 완성되고 이름이 붙은 하나의 스타일로 한 가지 결과물을 만드는 법을 가르치는 플레이북입니다. 예를 들면 HTML로 렌더링한 제품 출시 영상, 슬라이드 덱, 랜딩 페이지나 사이트 전체, 에디토리얼 이미지 세트 같은 것입니다. 스킬 하나는 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를 여세요.
시작하는 방법은 두 가지입니다.
- 채팅에서(권장). PopNow를 MCP 서버로 연결해 두고 만들고 싶은 것을 말하세요. 어시스턴트가 미리보기가 달린 스타일 몇 개를 보여 주면 하나를 고르고, PopNow가 그 스킬을 어시스턴트에게 넘겨 실행하게 합니다.
- 직접 설치. 에이전트에 설치 프롬프트를 붙여 넣거나, ZIP을 내려받거나, API 키로
curl을 쓰세요.
한눈에 보기
| 둘러보기 | 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 |
| 가격 | 찾기, 설치, 사용 모두 무료. 스킬이 만드는 이미지, 영상, 음악, 음성은 생성 요금이 들며 먼저 견적을 냅니다 |
| 개수 | 무료 계정: 하루에 새 스킬 5개, 전체 20개. 크레딧을 한 번이라도 구매한 뒤: 하루에 새 스킬 30개, 전체 한도 없음. 이미 추가한 스킬은 다시 세지 않습니다. 한도 참고 |
| 라이선스 | 나의 작업과 고객의 작업에 사용. 패키지를 공개하거나 재배포하지 마세요 |
채팅에서 스킬 고르기
PopNow를 한 번 연결하고(Claude, ChatGPT, Claude Code, Cursor 등) 원하는 결과를 요청하세요. 어시스턴트는 무료 도구 두 개를 씁니다.
- **
find_skills**가 요청을 카탈로그와 맞춰 보고, 가장 잘 맞는 스타일을 최대 4개 돌려줍니다. 각 항목에는 한 줄 설명, 어떤 용도에 가장 좋은지, 미리보기 영상과 표지 이미지, 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중 알맞은 도구를 대신 씁니다. 각 도구는 먼저 견적을 내며, 자동 승인 한도를 넘는 것은 가격과 승인에 설명된 대로 내 승인을 기다립니다. - 어떤 에이전트인지.
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> |
개인 폴더에 두면 모든 프로젝트에서 스킬을 쓸 수 있고, 프로젝트 폴더에 두면 그 저장소에서만 쓸 수 있습니다.
한도
스킬은 무료이지만, 한 계정이 추가할 수 있는 서로 다른 스킬 수에 상한이 있습니다. 웹사이트의 Download ZIP, 다운로드 엔드포인트, MCP의 use_skill이 모두 이 한도를 함께 씁니다. 아래 웹사이트 크레딧 구매 조건은 스킬 다운로드 자격에 관한 것으로 API 입금 조건이 아닙니다. 웹사이트 크레딧을 API 호출에 쓸 수 있게 되는 것은 아닙니다.
| 계정 | 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엔드포인트는 ZIP으로 가는 서명 링크를 담은 302를 돌려주며, 이 링크는 몇 분 뒤 만료됩니다. 그러니 항상 리디렉션을 따라가고(-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 | 다운로드가 잠시 불가능함. 1분 뒤 다시 시도하세요 |
에이전트 스킬에 비용이 드나요?
아니요. 스킬을 찾고 설치하고 실행하는 것은 무료입니다. PopNow로 만드는 이미지, 영상 클립, 음악, 음성 더빙에만 비용이 듭니다. API 키 호출은 API USD, OAuth MCP는 웹사이트 크레딧을 쓰며 같은 모델 요율이 적용됩니다. 스킬이 각 항목의 견적을 내고 내 승인을 기다립니다.
스킬은 몇 개까지 받을 수 있나요?
무료 계정은 하루에 새 스킬 5개, 전체 20개까지 추가할 수 있습니다. 크레딧을 구매하면 하루에 새 스킬 30개를 전체 한도 없이 추가할 수 있습니다. 이미 가진 스킬을 다시 내려받는 것은 절대 포함되지 않습니다. 한도를 보세요.
코딩 에이전트가 필요한가요?
웹사이트, 덱, 렌더링된 영상에는 필요합니다. 스킬이 내 컴퓨터에서 스크립트를 실행하고 파일을 만들기 때문입니다. 이미지 스킬은 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와 오픈 소스 도구를 보세요.