Agent Skills

개요

Agent Skills는 Dodo Payments로 작업할 때 AI coding assistant가 수행할 수 있는 작업을 확장하는 재사용 가능한 기능입니다. checkout flow 통합부터 usage-based billing 설정까지, agent가 특정 작업을 더욱 효과적으로 수행할 수 있도록 절차 지식과 best practice를 제공합니다.

Skills를 AI assistant를 위한 plugin이라고 생각해 보세요. 권장 패턴과 best practice에 따라 agent가 Dodo Payments 기능을 올바르게 구현하는 방법을 가르칩니다.

Skills protocol을 지원하는 모든 AI agent에서 Skills를 사용할 수 있습니다. 지원되는 agent는 다음과 같습니다.

Claude Code — Anthropic의 CLI coding assistant
Codex CLI — OpenAI의 CLI coding agent
Cursor — AI 중심의 code editor
VS Code / GitHub Copilot — Agent Plugin을 통해 사용
Kiro — Skills를 Power로 로드
OpenCode — open source AI coding agent
기타 client — Skills protocol을 지원하는 모든 agent

Gemini CLI는 예외입니다. agent-skill primitive가 없으므로 Gemini CLI에서는 Skills를 사용할 수 없으며, MCP servers 두 개만 사용할 수 있습니다.

사용 가능한 Skills

전체 통합 범위를 다루는 17개의 Skills를 작업 유형별로 그룹화했습니다.

시작하기

Skill	설명
dodo-best-practices	SDK 설정, 환경, API 키 및 표준 checkout-to-webhook 아키텍처
framework-adapters	Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun 및 Convex를 위한 공식 `@dodopayments/*` route handlers
testing-and-go-live	Test mode, test payment methods, webhook 테스트 및 production 출시 체크리스트

결제 수락

Skill	설명
checkout-integration	Checkout Sessions, payment links 및 overlay 또는 inline checkout
subscription-integration	Subscription lifecycle, trials, plan changes, proration 및 on-demand charges
mobile-checkout	React Native, Flutter, iOS 및 Android용 인앱 checkout
webhook-integration	Standard Webhooks specification을 사용한 webhook 수신 및 검증

Billing 모델

Skill	설명
credit-based-billing	Credit entitlements, balances, ledger, rollover, overage 및 meter-based deduction
usage-based-billing	Meters, event ingestion, aggregation 및 단위별 가격 책정
license-keys	License key activation, validation 및 instance management

Catalog 및 가격 책정

Skill	설명
product-catalog-management	Products, pricing, add-ons, collections, images 및 digital product delivery
discounts-and-promotions	Discount codes, eligibility rules, stacking 및 subscription-cycle limits
localized-pricing	현지화된 가격, Adaptive Currency 및 purchasing power parity

고객 및 운영

Skill	설명
customer-management	Customers, self-service portal, saved payment methods 및 wallets
refunds-and-disputes	Refund 발행, disputes 및 chargebacks 처리, access 조정

UI 및 통합

Skill	설명
billing-sdk	Pricing tables 및 billing UI를 위한 BillingSDK React components
better-auth-integration	Customer sync, checkout 및 portal access를 위한 `@dodopayments/better-auth` plugin

설치

사용 중인 AI coding assistant에 따라 원하는 설치 방법을 선택하세요.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

Dodo Agent Plugin은 Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro 및 OpenCode에 17개의 Skills와 두 MCP servers를 한 번에 설치합니다. agent가 관련 작업을 감지하면 Skills가 자동으로 로드됩니다.Agent별 설치 명령은 AI Coding Agents 가이드를 참조하세요.

Skills를 지원하는 모든 agent에서 작동하는 universal skills CLI를 사용해 Skills를 설치하세요:

# Install all Dodo Payments skills
npx skills add dodopayments/skills

또는 필요한 Skills를 개별적으로 설치하세요:

# Getting started
npx skills add dodopayments/skills/dodo-payments/dodo-best-practices
npx skills add dodopayments/skills/dodo-payments/framework-adapters
npx skills add dodopayments/skills/dodo-payments/testing-and-go-live

# Accepting payments
npx skills add dodopayments/skills/dodo-payments/checkout-integration
npx skills add dodopayments/skills/dodo-payments/subscription-integration
npx skills add dodopayments/skills/dodo-payments/mobile-checkout
npx skills add dodopayments/skills/dodo-payments/webhook-integration

# Billing models
npx skills add dodopayments/skills/dodo-payments/credit-based-billing
npx skills add dodopayments/skills/dodo-payments/usage-based-billing
npx skills add dodopayments/skills/dodo-payments/license-keys

# Catalog and pricing
npx skills add dodopayments/skills/dodo-payments/product-catalog-management
npx skills add dodopayments/skills/dodo-payments/discounts-and-promotions
npx skills add dodopayments/skills/dodo-payments/localized-pricing

# Customers and operations
npx skills add dodopayments/skills/dodo-payments/customer-management
npx skills add dodopayments/skills/dodo-payments/refunds-and-disputes

# UI and integrations
npx skills add dodopayments/skills/dodo-payments/billing-sdk
npx skills add dodopayments/skills/dodo-payments/better-auth-integration

필요한 Skills만 설치하여 agent가 작업에 집중하도록 하고 context overhead를 줄이세요.

Claude Code에 Dodo Payments Skills marketplace를 추가하세요:

/plugin marketplace add dodopayments/skills

그런 다음 개별 plugin을 설치하세요:

# Getting started
/plugin install dodo-best-practices
/plugin install framework-adapters
/plugin install testing-and-go-live

# Accepting payments
/plugin install checkout-integration
/plugin install subscription-integration
/plugin install mobile-checkout
/plugin install webhook-integration

# Billing models
/plugin install credit-based-billing
/plugin install usage-based-billing
/plugin install license-keys

# Catalog and pricing
/plugin install product-catalog-management
/plugin install discounts-and-promotions
/plugin install localized-pricing

# Customers and operations
/plugin install customer-management
/plugin install refunds-and-disputes

# UI and integrations
/plugin install billing-sdk
/plugin install better-auth-integration

OpenCode는 사용자가 지정한 directory에서 Skills를 로드합니다. 설치된 package를 scan하지 않으므로 명시적인 skills.paths 항목이 필요합니다.Agent Plugin package 사용:

npm install --save-dev @dodopayments/opencode-plugin

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "skills": {
    "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
  }
}

Relative path는 project directory를 기준으로 resolve되므로 package가 해당 project의 node_modules에 있어야 합니다. Absolute path를 사용할 수도 있으며, 이 경우 local-install requirement가 필요하지 않습니다.

존재하지 않는 Skills path는 조용히 무시됩니다 — error도 warning도 표시되지 않습니다. Skills가 실제로 로드되었는지 확인하세요:

opencode run "List every skill available to you by name."

17개가 모두 표시되어야 합니다.

Skills 사용

설치가 완료되면 AI assistant는 Dodo Payments 기능을 구현해 달라는 요청을 받았을 때 관련 Skills를 자동으로 로드합니다. Skills 이름을 지정할 필요 없이 작업을 설명하면 됩니다.

예시 prompt	로드되는 Skill
best practice에 따라 Dodo Payments를 내 Next.js app에 통합해 줘	`dodo-best-practices`
내 Hono app에 Dodo Payments checkout route handler를 추가해 줘	`framework-adapters`
payment을 테스트하고 live 환경으로 전환하는 방법을 안내해 줘	`testing-and-go-live`
내 SaaS product를 위한 checkout session을 생성해 줘	`checkout-integration`
free trial과 여러 pricing tier를 포함한 subscription flow를 구현해 줘	`subscription-integration`
내 React Native app에 in-app checkout을 추가해 줘	`mobile-checkout`
payment 및 subscription event를 위한 webhook handler를 설정해 줘	`webhook-integration`
내 AI product를 위해 credit entitlement와 metered credit deduction을 설정해 줘	`credit-based-billing`
내 AI product의 API call을 추적할 수 있도록 usage-based billing을 추가해 줘	`usage-based-billing`
내 desktop app에 대한 license key validation을 구현해 줘	`license-keys`
add-on과 tiered pricing을 포함한 product catalog를 생성해 줘	`product-catalog-management`
첫 3개 billing cycle에서 20% 할인을 제공하는 promo code를 추가해 줘	`discounts-and-promotions`
purchasing power parity를 적용해 방문자의 현지 통화로 가격을 표시해 줘	`localized-pricing`
고객이 payment method를 직접 관리할 수 있는 self-service portal을 제공해 줘	`customer-management`
dispute가 열리면 partial refund를 처리하고 access를 revoke해 줘	`refunds-and-disputes`
BillingSDK component를 사용해 pricing page를 추가해 줘	`billing-sdk`
Dodo Payments를 내 Better Auth setup에 연결해 줘	`better-auth-integration`

Skills 작동 방식

Skills는 AI assistant에 다음을 제공합니다:

Procedural Knowledge — 기능 구현을 위한 단계별 지침
Code Templates — production-ready code pattern과 snippet
Best Practices — security, error handling 및 UX를 위한 권장 접근 방식
Context Awareness — 다양한 Dodo Payments 기능이 함께 작동하는 방식에 대한 이해

AI assistant에 기능 구현을 요청하면 관련 Skills를 사용해 올바른 구현 방식을 파악하고, 정확하게 작동하는 code를 생성하며, Dodo Payments convention을 따르고, edge case와 error를 적절히 처리합니다.

Skills는 MCP Server를 보완합니다. API operation에는 MCP를 사용하고, 향상된 AI assistant capability에는 Skills를 사용하세요.

다른 Tool과의 비교

Tool	목적	적합한 용도
Agent Skills	AI assistant의 knowledge 향상	Skills를 지원하는 모든 agent를 활용한 AI-assisted development
MCP Server	API operation 실행	AI assistant에서 직접 API access

Resources

Skills Repository

source code를 살펴보고 Dodo Payments Skills에 기여

MCP Server

AI assistant가 Dodo Payments API operation을 실행할 수 있도록 활성화

Build with AI Coding Agents

Agent Plugin 설치: 모든 Skills와 두 MCP servers를 한 번에 설치

Discord Community

커뮤니티에서 도움을 받고 feedback 공유

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

개요

사용 가능한 Skills

시작하기

결제 수락

Billing 모델

Catalog 및 가격 책정

고객 및 운영

UI 및 통합

설치

Skills 사용

Skills 작동 방식

다른 Tool과의 비교

Resources

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

​개요

​사용 가능한 Skills

​시작하기

​결제 수락

​Billing 모델

​Catalog 및 가격 책정

​고객 및 운영

​UI 및 통합

​설치

​Skills 사용

​Skills 작동 방식

​다른 Tool과의 비교

​Resources

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

개요

사용 가능한 Skills

시작하기

결제 수락

Billing 모델

Catalog 및 가격 책정

고객 및 운영

UI 및 통합

설치

Skills 사용

Skills 작동 방식

다른 Tool과의 비교

Resources