Agent Skills

개요

Agent Skills는 Dodo Payments와 함께 작업할 때 AI 코딩 assistant의 기능을 확장하는 재사용 가능한 기능입니다. checkout 흐름 통합부터 사용량 기반 billing 설정까지, agent가 특정 작업을 더욱 효과적으로 수행할 수 있도록 절차 지식과 모범 사례를 제공합니다.

skills를 AI assistant용 플러그인이라고 생각해 보세요. agent가 권장 패턴과 모범 사례에 따라 Dodo Payments 기능을 올바르게 구현하는 방법을 학습하도록 지원합니다.

Skills는 다음을 포함한 모든 MCP 호환 AI agent에서 작동합니다:

Claude Code - Anthropic의 CLI 코딩 assistant
OpenCode - 오픈 소스 AI 코딩 agent
Cursor - AI 중심 코드 editor
기타 MCP client - skills protocol을 지원하는 모든 agent

사용 가능한 Skills

통합 전반을 다루는 17개의 스킬을 작업별로 그룹화했습니다.

시작하기

Skill	Description
dodo-best-practices	SDK 설정, 환경, API 키, 그리고 checkout에서 webhook으로 이어지는 표준 아키텍처
framework-adapters	Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun, Convex를 위한 공식 `@dodopayments/*` route handlers
testing-and-go-live	테스트 모드, 테스트 결제 수단, webhook 테스트, 프로덕션 출시 체크리스트

결제 수락

Skill	Description
checkout-integration	Checkout Sessions, 결제 링크, overlay 또는 inline checkout
subscription-integration	구독 수명 주기, 무료 체험, 플랜 변경, 비례 배분, 주문형 요금 청구
mobile-checkout	React Native, Flutter, iOS, Android를 위한 인앱 checkout
webhook-integration	Standard Webhooks 사양을 사용한 webhook 수신 및 검증

청구 모델

Skill	Description
credit-based-billing	크레딧 권한, 잔액, 원장, 이월, 초과 사용량, 미터 기반 차감
usage-based-billing	미터, 이벤트 수집, 집계, 단위별 가격 책정
license-keys	라이선스 키 활성화, 검증, 인스턴스 관리

카탈로그 및 가격 책정

Skill	Description
product-catalog-management	제품, 가격, 추가 기능, 컬렉션, 이미지, 디지털 제품 제공
discounts-and-promotions	할인 코드, 자격 규칙, 중복 적용, 구독 주기 제한
localized-pricing	현지화된 가격, Adaptive Currency, 구매력 평가

고객 및 운영

Skill	Description
customer-management	고객, 셀프 서비스 포털, 저장된 결제 수단, 지갑
refunds-and-disputes	환불 처리, 분쟁 및 chargeback 처리, 액세스 조정

UI 및 통합

Skill	Description
billing-sdk	가격표 및 청구 UI를 위한 BillingSDK React 컴포넌트
better-auth-integration	고객 동기화, checkout, 포털 액세스를 위한 `@dodopayments/better-auth` plugin

설치

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

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

Claude Code, Codex CLI, Cursor 또는 OpenCode를 사용하는 경우 Dodo Agent Plugin을 통해 17개의 스킬과 두 개의 MCP 서버를 한 번에 설치할 수 있습니다. 에이전트가 관련 작업을 감지하면 스킬이 자동으로 로드됩니다.에이전트별 설치 명령은 AI Coding Agents 가이드를 참조하세요.

모든 MCP 호환 에이전트에서 작동하는 universal skills CLI를 사용하여 스킬을 설치하세요:

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

또는 필요에 따라 개별 스킬을 설치하세요:

# Getting started
npx skills add dodopayments/skills/dodo-payments/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

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

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

/plugin marketplace add dodopayments/skills

그런 다음 개별 플러그인을 설치하세요:

# 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 설정에서 구성하면 스킬을 자동으로 사용할 수 있습니다. Dodo Payments skills repository를 설정에 추가하세요:

{
  "skills": {
    "repositories": [
      "dodopayments/skills"
    ]
  }
}

스킬 사용

설치가 완료되면 AI assistant에 Dodo Payments 기능 구현을 요청할 때 관련 스킬이 자동으로 로드됩니다. 스킬 이름을 지정할 필요 없이 작업을 설명하기만 하면 됩니다.

Example prompt	Skill that loads
모범 사례에 따라 내 Next.js 앱에 Dodo Payments 통합하기	`dodo-best-practices`
내 Hono 앱에 Dodo Payments checkout route handler 추가하기	`framework-adapters`
결제 테스트 및 라이브 전환 과정을 안내해 줘	`testing-and-go-live`
내 SaaS 제품을 위한 checkout session 생성하기	`checkout-integration`
무료 체험과 여러 가격 등급을 포함한 구독 흐름 구현하기	`subscription-integration`
내 React Native 앱에 인앱 checkout 추가하기	`mobile-checkout`
결제 및 구독 이벤트를 위한 webhook handler 설정하기	`webhook-integration`
내 AI 제품을 위한 크레딧 권한 및 미터링 기반 크레딧 차감 설정하기	`credit-based-billing`
내 AI 제품의 API 호출을 추적하기 위한 usage-based billing 추가하기	`usage-based-billing`
내 데스크톱 앱을 위한 라이선스 키 검증 구현하기	`license-keys`
추가 기능과 등급별 가격이 포함된 제품 카탈로그 생성하기	`product-catalog-management`
처음 3번의 청구 주기에 20% 할인을 제공하는 프로모션 코드 추가하기	`discounts-and-promotions`
구매력 평가를 적용하여 방문자의 현지 통화로 가격 표시하기	`localized-pricing`
고객이 결제 수단을 관리할 수 있는 셀프 서비스 포털 제공하기	`customer-management`
부분 환불을 처리하고 분쟁이 열리면 액세스 철회하기	`refunds-and-disputes`
BillingSDK 컴포넌트를 사용하여 가격 페이지 추가하기	`billing-sdk`
Dodo Payments를 내 Better Auth 설정에 연결하기	`better-auth-integration`

스킬 작동 방식

스킬은 AI assistant에 다음을 제공합니다:

절차 지식 - 기능 구현을 위한 단계별 지침
코드 템플릿 - 프로덕션에 바로 사용할 수 있는 코드 패턴 및 snippet
모범 사례 - 보안, 오류 처리, UX를 위한 권장 접근 방식
컨텍스트 인식 - 서로 다른 Dodo Payments 기능이 함께 작동하는 방식에 대한 이해

AI assistant에 기능 구현을 요청하면 관련 스킬을 사용하여 다음을 수행합니다:

올바른 구현 방식 이해
정확하고 작동하는 코드 생성
Dodo Payments 규칙 준수
edge case 및 오류의 적절한 처리

스킬은 MCP Server 및 Sentra를 보완합니다. API 작업에는 MCP를, 안내형 통합에는 Sentra를, 향상된 AI assistant 기능에는 스킬을 사용하세요.

다른 도구와의 비교

Tool	Purpose	Best For
Agent Skills	AI assistant 지식 향상	모든 MCP client를 활용한 AI 지원 개발
MCP Server	API 작업 실행	AI assistant에서 직접 API 액세스
Sentra	안내형 통합 assistant	IDE에서 대화형 청구 통합

리소스

Skills Repository

소스 코드를 둘러보고 Dodo Payments 스킬에 기여하세요

MCP Server

AI assistant가 Dodo Payments API 작업을 실행할 수 있도록 설정하세요

Sentra

IDE를 위한 AI 기반 청구 assistant

Discord Community

커뮤니티에서 도움을 받고 피드백을 공유하세요

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

개요

사용 가능한 Skills

시작하기

결제 수락

청구 모델

카탈로그 및 가격 책정

고객 및 운영

UI 및 통합

설치

스킬 사용

스킬 작동 방식

다른 도구와의 비교

리소스

Skills Repository

MCP Server

Sentra

Discord Community

​개요

​사용 가능한 Skills

​시작하기

​결제 수락

​청구 모델

​카탈로그 및 가격 책정

​고객 및 운영

​UI 및 통합

​설치

​스킬 사용

​스킬 작동 방식

​다른 도구와의 비교

​리소스

Skills Repository

MCP Server

Sentra

Discord Community

개요

사용 가능한 Skills

시작하기

결제 수락

청구 모델

카탈로그 및 가격 책정

고객 및 운영

UI 및 통합

설치

스킬 사용

스킬 작동 방식

다른 도구와의 비교

리소스