Agent Skills

Overview

Agent Skills are reusable capabilities that enhance what AI coding assistants can do when working with Dodo Payments. They provide procedural knowledge and best practices that help agents accomplish specific tasks more effectively - from integrating checkout flows to setting up usage-based billing.

Think of skills as plugins for your AI assistant. They teach your agent how to implement Dodo Payments features correctly, following our recommended patterns and best practices.

Skills hoạt động với mọi AI agent hỗ trợ skills protocol, bao gồm:

Claude Code - trợ lý lập trình CLI của Anthropic
Codex CLI - coding agent CLI của OpenAI
Cursor - trình soạn thảo mã ưu tiên AI
VS Code / GitHub Copilot - thông qua Agent Plugin
Kiro - tải skills dưới dạng Power
OpenCode - coding agent AI nguồn mở
Các client khác - mọi agent hỗ trợ skills protocol

Gemini CLI là ngoại lệ. Công cụ này không có agent-skill primitive, vì vậy skills không khả dụng ở đó — chỉ có hai MCP servers.

Skills khả dụng

Mười bảy skills bao phủ toàn bộ bề mặt tích hợp, được nhóm theo tác vụ bạn đang thực hiện.

Bắt đầu

Skill	Mô tả
dodo-best-practices	Thiết lập SDK, môi trường, API keys và kiến trúc checkout-to-webhook chuẩn
framework-adapters	Các route handlers `@dodopayments/*` chính thức cho Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun và Convex
testing-and-go-live	Test mode, test payment methods, kiểm thử webhook và checklist đưa vào production

Chấp nhận thanh toán

Skill	Mô tả
checkout-integration	Checkout Sessions, payment links và checkout dạng overlay hoặc inline
subscription-integration	Vòng đời subscription, trial, thay đổi gói, proration và các khoản phí theo nhu cầu
mobile-checkout	Checkout trong ứng dụng cho React Native, Flutter, iOS và Android
webhook-integration	Tiếp nhận và xác minh webhook bằng đặc tả Standard Webhooks

Mô hình tính phí

Skill	Mô tả
credit-based-billing	Quyền sử dụng credit, số dư, sổ cái, rollover, overage và khấu trừ dựa trên meter
usage-based-billing	Meter, tiếp nhận sự kiện, tổng hợp và định giá theo đơn vị
license-keys	Kích hoạt, xác thực license key và quản lý instance

Danh mục và định giá

Skill	Mô tả
product-catalog-management	Product, pricing, add-on, collection, hình ảnh và phân phối sản phẩm kỹ thuật số
discounts-and-promotions	Mã giảm giá, quy tắc đủ điều kiện, stacking và giới hạn theo chu kỳ subscription
localized-pricing	Định giá theo địa phương, Adaptive Currency và purchasing power parity

Khách hàng và vận hành

Skill	Mô tả
customer-management	Khách hàng, self-service portal, payment methods đã lưu và ví
refunds-and-disputes	Phát hành refund, xử lý dispute và chargeback, đồng thời đối soát quyền truy cập

UI và tích hợp

Skill	Mô tả
billing-sdk	Component BillingSDK React cho bảng pricing và billing UI
better-auth-integration	Plugin `@dodopayments/better-auth` cho đồng bộ khách hàng, checkout và quyền truy cập portal

Cài đặt

Chọn phương thức cài đặt phù hợp dựa trên trợ lý lập trình AI của bạn.

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

Nếu bạn sử dụng Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro hoặc OpenCode, Dodo Agent Plugin sẽ cài đặt cả mười bảy skills cùng hai MCP servers chỉ trong một bước. Skills được tự động tải khi agent phát hiện một tác vụ phù hợp.Xem hướng dẫn AI Coding Agents để biết lệnh cài đặt cho từng agent.

Cài đặt skills bằng universal skills CLI hoạt động với mọi agent tương thích MCP:

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

Hoặc cài đặt từng skill theo nhu cầu:

# 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

Chỉ cài đặt những skills bạn cần để agent tập trung hơn và giảm chi phí context.

Thêm marketplace skills của Dodo Payments vào Claude Code:

/plugin marketplace add dodopayments/skills

Sau đó cài đặt từng 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 tải skills từ các thư mục mà bạn chỉ định. Công cụ này không quét các package đã cài đặt, vì vậy cần có mục skills.paths rõ ràng.Sử dụng package Agent Plugin:

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"]
  }
}

Các đường dẫn tương đối được phân giải dựa trên thư mục project, vì vậy package phải có trong node_modules của project đó. Bạn cũng có thể sử dụng đường dẫn tuyệt đối để tránh yêu cầu cài đặt cục bộ.

Đường dẫn skills không tồn tại sẽ bị bỏ qua một cách im lặng — không lỗi, không cảnh báo. Xác nhận rằng skills đã thực sự được tải:

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

Bạn sẽ thấy đủ mười bảy skill.

Sử dụng Skills

Sau khi cài đặt, trợ lý AI sẽ tự động tải skill phù hợp khi bạn yêu cầu triển khai một tính năng Dodo Payments. Bạn không cần nêu tên skill — chỉ cần mô tả tác vụ.

Prompt mẫu	Skill được tải
Giúp tôi tích hợp Dodo Payments vào ứng dụng Next.js theo các phương pháp tốt nhất	`dodo-best-practices`
Thêm route handler checkout của Dodo Payments vào ứng dụng Hono	`framework-adapters`
Hướng dẫn tôi kiểm thử thanh toán và đưa vào hoạt động	`testing-and-go-live`
Tạo checkout session cho sản phẩm SaaS của tôi	`checkout-integration`
Triển khai quy trình subscription với free trial và nhiều pricing tier	`subscription-integration`
Thêm checkout trong ứng dụng vào app React Native của tôi	`mobile-checkout`
Thiết lập webhook handlers cho các sự kiện thanh toán và subscription	`webhook-integration`
Thiết lập quyền sử dụng credit và khấu trừ credit theo meter cho sản phẩm AI của tôi	`credit-based-billing`
Thêm usage-based billing để theo dõi các API call cho sản phẩm AI của tôi	`usage-based-billing`
Triển khai xác thực license key cho ứng dụng desktop của tôi	`license-keys`
Tạo product catalog với add-on và pricing theo tier	`product-catalog-management`
Thêm promo code giảm 20% cho ba billing cycle đầu tiên	`discounts-and-promotions`
Hiển thị giá bằng local currency của khách truy cập với purchasing power parity	`localized-pricing`
Cung cấp self-service portal để khách hàng quản lý payment methods	`customer-management`
Phát hành partial refund và thu hồi quyền truy cập khi dispute được mở	`refunds-and-disputes`
Thêm trang pricing bằng các component BillingSDK	`billing-sdk`
Tích hợp Dodo Payments vào thiết lập Better Auth của tôi	`better-auth-integration`

Skills hoạt động như thế nào

Skills cung cấp cho trợ lý AI của bạn:

Kiến thức quy trình - Hướng dẫn từng bước để triển khai tính năng
Code template - Các mẫu code và đoạn mã sẵn sàng cho production
Best practices - Phương pháp được đề xuất cho bảo mật, xử lý lỗi và UX
Nhận biết context - Hiểu cách các tính năng khác nhau của Dodo Payments phối hợp với nhau

Khi bạn yêu cầu trợ lý AI triển khai một tính năng, trợ lý sẽ sử dụng skill phù hợp để:

Hiểu phương pháp triển khai chính xác
Tạo code chính xác và hoạt động được
Tuân thủ các quy ước của Dodo Payments
Xử lý đúng các trường hợp đặc biệt và lỗi

Skills bổ trợ cho MCP Server và Sentra. Sử dụng MCP cho các thao tác API, Sentra cho tích hợp có hướng dẫn và Skills để nâng cao khả năng của trợ lý AI.

So sánh với các công cụ khác

Công cụ	Mục đích	Phù hợp nhất cho
Agent Skills	Nâng cao kiến thức của trợ lý AI	Phát triển có AI hỗ trợ với mọi MCP client
MCP Server	Thực thi các thao tác API	Truy cập API trực tiếp từ trợ lý AI
Sentra	Trợ lý tích hợp có hướng dẫn	Tích hợp billing tương tác trong IDE

Tài nguyên

Skills Repository

Duyệt mã nguồn và đóng góp cho skills của Dodo Payments

MCP Server

Cho phép trợ lý AI thực thi các thao tác API của Dodo Payments

Sentra

Trợ lý billing hỗ trợ AI cho IDE của bạn

Discord Community

Nhận trợ giúp và chia sẻ phản hồi với cộng đồng

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Skills khả dụng

Bắt đầu

Chấp nhận thanh toán

Mô hình tính phí

Danh mục và định giá

Khách hàng và vận hành

UI và tích hợp

Cài đặt

Sử dụng Skills

Skills hoạt động như thế nào

So sánh với các công cụ khác

Tài nguyên

Skills Repository

MCP Server

Sentra

Discord Community

​Overview

​Skills khả dụng

​Bắt đầu

​Chấp nhận thanh toán

​Mô hình tính phí

​Danh mục và định giá

​Khách hàng và vận hành

​UI và tích hợp

​Cài đặt

​Sử dụng Skills

​Skills hoạt động như thế nào

​So sánh với các công cụ khác

​Tài nguyên

Skills Repository

MCP Server

Sentra

Discord Community

Overview

Skills khả dụng

Bắt đầu

Chấp nhận thanh toán

Mô hình tính phí

Danh mục và định giá

Khách hàng và vận hành

UI và tích hợp

Cài đặt

Sử dụng Skills

Skills hoạt động như thế nào

So sánh với các công cụ khác

Tài nguyên