Agent Skills

Overview

Agent Skills là các khả năng có thể tái sử dụng, giúp nâng cao những gì các trợ lý lập trình AI có thể thực hiện khi làm việc với Dodo Payments. Chúng cung cấp kiến thức quy trình và các best practice, giúp agent hoàn thành những tác vụ cụ thể hiệu quả hơn—từ tích hợp các quy trình checkout đến thiết lập usage-based billing.

Hãy xem skills như các plugin cho trợ lý AI của bạn. Chúng hướng dẫn agent cách triển khai đúng các tính năng của Dodo Payments, tuân theo các pattern và best practice được khuyến nghị.

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 code ư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 mã nguồn mở
Các client khác — mọi agent hỗ trợ skills protocol

Gemini CLI là ngoại lệ. Gemini CLI không có agent-skill primitive, vì vậy skills không khả dụng trên đó—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

Dodo Agent Plugin cài đặt toàn bộ mười bảy skills cùng cả hai MCP servers chỉ trong một bước cho Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro và OpenCode. 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 hỗ trợ skills:

# 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 context overhead.

Thêm Dodo Payments skills marketplace 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. OpenCode không quét các package đã cài đặt, vì vậy cần có một mục skills.paths tường minh.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 path tương đối được phân giải dựa trên thư mục project, vì vậy package phải có mặt trong node_modules của project đó. Path tuyệt đối cũng hoạt động và giúp tránh yêu cầu cài đặt cục bộ.

Một skills path 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. Hãy xác nhận 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 cài đặt, AI assistant của bạn 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 của Dodo Payments. Bạn không cần nêu tên skill; thay vào đó, hãy mô tả tác vụ.

Prompt mẫu	Skill được tải
Giúp tôi tích hợp Dodo Payments vào app Next.js theo best practice	`dodo-best-practices`
Thêm checkout route handler của Dodo Payments vào app Hono của tôi	`framework-adapters`
Hướng dẫn tôi kiểm thử thanh toán và go live	`testing-and-go-live`
Tạo checkout session cho sản phẩm SaaS của tôi	`checkout-integration`
Triển khai subscription flow với free trial và nhiều pricing tier	`subscription-integration`
Thêm in-app checkout vào app React Native của tôi	`mobile-checkout`
Thiết lập webhook handler cho các sự kiện payment và subscription	`webhook-integration`
Thiết lập credit entitlement và metered credit deduction 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 license key validation cho desktop app của tôi	`license-keys`
Tạo product catalog với add-on và tiered pricing	`product-catalog-management`
Thêm promo code giảm 20% trong ba billing cycle đầu tiên	`discounts-and-promotions`
Hiển thị giá theo local currency của khách truy cập với purchasing power parity	`localized-pricing`
Cung cấp cho khách hàng self-service portal để quản lý payment method	`customer-management`
Thực hiện partial refund và thu hồi quyền truy cập khi dispute được mở	`refunds-and-disputes`
Thêm pricing page bằng các component của 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 AI assistant 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 pattern và snippet code sẵn sàng cho production
Best practice — Các phương pháp được khuyến nghị cho security, error handling và UX
Nhận biết context — Hiểu cách các tính năng khác nhau của Dodo Payments hoạt động cùng nhau

Khi bạn yêu cầu AI assistant triển khai một tính năng, assistant sẽ sử dụng skill phù hợp để hiểu phương pháp triển khai chính xác, tạo code hoạt động chính xác, tuân theo các quy ước của Dodo Payments, đồng thời xử lý đúng các edge case và lỗi.

Skills bổ trợ cho MCP Server. Sử dụng MCP cho các API operation và Skills để nâng cao khả năng của AI assistant.

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 AI assistant	Phát triển có AI hỗ trợ với mọi agent hỗ trợ skills
MCP Server	Thực thi API operation	Truy cập API trực tiếp từ AI assistant

Tài nguyên

Skills Repository

Duyệt source code và đóng góp cho Dodo Payments skills

MCP Server

Cho phép AI assistant thực thi các Dodo Payments API operation

Build with AI Coding Agents

Cài đặt Agent Plugin: toàn bộ skills cùng cả hai MCP servers chỉ trong một bước

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

Build with AI Coding Agents

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

Build with AI Coding Agents

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