Agent Skills

概要

Agent Skillsは、Dodo Paymentsを扱う際にAI coding assistantが実行できることを拡張する、再利用可能な機能です。checkout flowの統合からusage-based billingの設定まで、特定のタスクをより効果的に達成できるよう、手順に関する知識とベストプラクティスを提供します。

skillsはAI assistant向けのプラグインだと考えてください。 推奨されるパターンとベストプラクティスに従い、Dodo Paymentsの機能を正しく実装する方法をagentに教えます。

Skillsは、skills protocolをサポートするあらゆるAI 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
その他のクライアント — skills protocolをサポートするあらゆるagent

Gemini CLIは例外です。 agent-skill primitiveがないため、skillsは利用できません。利用できるのは2つのMCP serversのみです。

利用可能なSkills

統合の全領域をカバーする17個のSkillsを、作業中のタスク別にグループ化しています。

はじめに

Skill	Description
dodo-best-practices	SDKのセットアップ、環境、API keys、標準的な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 testing、本番ローンチチェックリスト

決済の受け付け

Skill	Description
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を使用したwebhooksの受信と検証

Billingモデル

Skill	Description
credit-based-billing	Credit entitlements、balances、ledger、rollover、overage、meter-based deduction
usage-based-billing	Meters、event ingestion、aggregation、per-unit pricing
license-keys	License keyのactivation、validation、instance management

CatalogとPricing

Skill	Description
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	Localized pricing、Adaptive Currency、purchasing power parity

CustomersとOperations

Skill	Description
customer-management	Customers、self-service portal、saved payment methods、wallets
refunds-and-disputes	Refundsの発行、disputesとchargebacksへの対応、accessのreconciling

UIとIntegrations

Skill	Description
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を1ステップでインストールします。agentが関連するタスクを検出すると、skillsは自動的に読み込まれます。agentごとのインストールコマンドについては、AI Coding Agents guideを参照してください。

skillsをサポートするあらゆるagentで使える汎用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を削減します。

Dodo Payments skills marketplaceをClaude Codeに追加します。

/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は、指定したディレクトリからskillsを読み込みます。インストール済みのパッケージをスキャンすることはないため、明示的な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"]
  }
}

相対パスはproject directoryを基準に解決されるため、そのプロジェクトのnode_modulesにパッケージが存在している必要があります。絶対パスも使用でき、その場合はlocal-install requirementを回避できます。

存在しないskills pathは黙って無視されます。エラーも警告も表示されません。skillsが実際に読み込まれたことを確認します。

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

17個すべてが表示されるはずです。

Skillsの使用

インストールすると、Dodo Paymentsの機能を実装するよう依頼した際に、AI assistantが関連するskillを自動的に読み込みます。skillの名前を指定する必要はありません。代わりにタスクを説明してください。

Example prompt	Skill that loads
ベストプラクティスに従ってDodo PaymentsをNext.js appに統合してください	`dodo-best-practices`
Dodo Paymentsのcheckout route handlerをHono appに追加してください	`framework-adapters`
paymentsのテストと本番公開について案内してください	`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% offになるpromo codeを追加してください	`discounts-and-promotions`
purchasing power parityを適用し、訪問者のlocal currencyで価格を表示してください	`localized-pricing`
customersがpayment methodを管理できるself-service portalを提供してください	`customer-management`
partial refundを発行し、disputeが開始された際にaccessを取り消してください	`refunds-and-disputes`
BillingSDK componentsを使用したpricing pageを追加してください	`billing-sdk`
Dodo PaymentsをBetter Auth setupに接続してください	`better-auth-integration`

Skillsの仕組み

SkillsはAI assistantに次の情報を提供します。

Procedural Knowledge — 機能を実装するためのstep-by-step instructions
Code Templates — production-readyなcode patternとsnippet
Best Practices — security、error handling、UXに関する推奨アプローチ
Context Awareness — Dodo Paymentsの各機能がどのように連携するかについての理解

AI assistantに機能の実装を依頼すると、関連するskillを使用して正しい実装アプローチを理解し、正確に動作するcodeを生成し、Dodo Paymentsの規約に従い、edge caseとerrorを適切に処理します。

SkillsはMCP Serverを補完します。API operationsにはMCPを、AI assistantの機能強化にはSkillsを使用してください。

他のツールとの比較

Tool	Purpose	Best For
Agent Skills	AI assistantの知識を強化	skillsをサポートするあらゆるagentを使ったAI-assisted development
MCP Server	API operationsを実行	AI assistantからの直接的なAPI access

Resources

Skills Repository

source codeを確認し、Dodo Payments skillsに貢献する

MCP Server

AI assistantがDodo Payments API operationsを実行できるようにする

Build with AI Coding Agents

Agent Pluginをインストールする：すべてのskillsと両方のMCP serversを1ステップで導入

Discord Community

コミュニティからサポートを受け、フィードバックを共有する

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

概要

利用可能なSkills

はじめに

決済の受け付け

Billingモデル

CatalogとPricing

CustomersとOperations

UIとIntegrations

インストール

Skillsの使用

Skillsの仕組み

他のツールとの比較

Resources

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

​概要

​利用可能なSkills

​はじめに

​決済の受け付け

​Billingモデル

​CatalogとPricing

​CustomersとOperations

​UIとIntegrations

​インストール

​Skillsの使用

​Skillsの仕組み

​他のツールとの比較

​Resources

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

概要

利用可能なSkills

はじめに

決済の受け付け

Billingモデル

CatalogとPricing

CustomersとOperations

UIとIntegrations

インストール

Skillsの使用

Skillsの仕組み

他のツールとの比較

Resources