Agent Skills

概要

Agent Skills は、AI コーディングアシスタントが Dodo Payments を扱う際に実行できることを拡張する、再利用可能な機能です。手続きに関する知識とベストプラクティスを提供し、checkout フローの統合から usage-based billing の設定まで、エージェントが特定のタスクをより効果的に遂行できるよう支援します。

skills は AI アシスタント向けのプラグインだと考えてください。 エージェントが推奨パターンとベストプラクティスに従って、Dodo Payments の機能を正しく実装できるようにします。

Skills は、次のような MCP-compatible AI エージェントで利用できます。

Claude Code - Anthropic の CLI コーディングアシスタント
OpenCode - オープンソースの AI コーディングエージェント
Cursor - AI-first のコードエディター
その他の MCP clients - skills protocol に対応するあらゆるエージェント

利用可能な Skills

統合の全領域をカバーする17のスキルを、取り組むタスクごとにグループ化しています。

はじめに

Skill	Description
dodo-best-practices	SDKのセットアップ、環境、API keys、および正規のcheckoutから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のライフサイクル、トライアル、プラン変更、proration、オンデマンド請求
mobile-checkout	React Native、Flutter、iOS、Android向けのアプリ内checkout
webhook-integration	Standard Webhooks仕様を使用したwebhookの受信と検証

Billingモデル

Skill	Description
credit-based-billing	Credit entitlement、残高、ledger、rollover、超過分、meterベースの控除
usage-based-billing	Meter、イベント取り込み、集計、単位ごとの価格設定
license-keys	License keyの有効化、検証、インスタンス管理

カタログと価格設定

Skill	Description
product-catalog-management	Products、pricing、add-ons、collections、画像、デジタル商品の提供
discounts-and-promotions	Discount codes、適用条件、併用、subscription cycleの上限
localized-pricing	ローカライズされた価格設定、Adaptive Currency、購買力平価

顧客と運用

Skill	Description
customer-management	顧客、セルフサービスポータル、保存済みのpayment methods、wallets
refunds-and-disputes	Refundの発行、disputesとchargebacksへの対応、アクセス権の照合

UIと統合

Skill	Description
billing-sdk	価格表とbilling UI向けのBillingSDK React components
better-auth-integration	顧客同期、checkout、portal accessのための`@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 serversを1ステップでインストールできます。agentが関連するタスクを検出すると、スキルは自動的に読み込まれます。agentごとのインストールコマンドについては、AI Coding Agents guideを参照してください。

任意のMCP-compatible agentで動作する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

必要なスキルだけをインストールして、agentの焦点を維持し、コンテキストのオーバーヘッドを減らします。

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

/plugin marketplace add dodopayments/skills

次に、個別のpluginsをインストールします。

# 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 settingsで設定すると、スキルは自動的に利用可能になります。Dodo Payments skills repositoryを設定に追加します。

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

スキルの使用

インストール後、Dodo Paymentsの機能の実装を依頼すると、AI assistantは関連するスキルを自動的に読み込みます。スキル名を指定する必要はありません。タスクを説明するだけで十分です。

Example prompt	Skill that loads
Dodo Paymentsをベストプラクティスに従ってNext.jsアプリに統合するのを手伝って	`dodo-best-practices`
HonoアプリにDodo Payments checkout route handlerを追加して	`framework-adapters`
決済のテストと本番開始までの手順を説明して	`testing-and-go-live`
SaaS product用のcheckout sessionを作成して	`checkout-integration`
無料トライアルと複数の価格帯を含むsubscription flowを実装して	`subscription-integration`
React Nativeアプリにアプリ内checkoutを追加して	`mobile-checkout`
paymentとsubscriptionのイベント用webhook handlersを設定して	`webhook-integration`
AI product用のcredit entitlementsとmetered credit deductionを設定して	`credit-based-billing`
AI productのAPI callsを追跡するusage-based billingを追加して	`usage-based-billing`
desktop app用のlicense key validationを実装して	`license-keys`
add-onsとtiered pricingを含むproduct catalogを作成して	`product-catalog-management`
最初の3 billing cyclesが20% offになるpromo codeを追加して	`discounts-and-promotions`
購買力平価を適用して訪問者の現地通貨で価格を表示して	`localized-pricing`
顧客がpayment methodsを管理できるself-service portalを提供して	`customer-management`
partial refundを発行し、disputeが開始されたらアクセス権を取り消して	`refunds-and-disputes`
BillingSDK componentsを使用してpricing pageを追加して	`billing-sdk`
Dodo PaymentsをBetter Auth setupに接続して	`better-auth-integration`

スキルの仕組み

スキルはAI assistantに次の情報を提供します。

手順に関する知識 - 機能を実装するためのステップごとの手順
Code Templates - 本番環境で使用できるコードパターンとスニペット
Best Practices - security、error handling、UXに推奨されるアプローチ
Context Awareness - Dodo Paymentsの各機能がどのように連携するかの理解

AI assistantに機能の実装を依頼すると、関連するスキルを使用して次のことを行います。

正しい実装アプローチを理解する
正確で動作するコードを生成する
Dodo Paymentsの規約に従う
edge casesとerrorsを適切に処理する

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

他のツールとの比較

Tool	Purpose	Best For
Agent Skills	AI assistantの知識を強化	任意のMCP clientを使用したAI支援開発
MCP Server	API operationsを実行	AI assistantからの直接的なAPI access
Sentra	Guided integration assistant	IDEでのinteractive billing integration

リソース

Skills Repository

ソースコードを閲覧し、Dodo Payments skillsに貢献する

MCP Server

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

Sentra

IDE向けのAI搭載billing assistant

Discord Community

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

概要

利用可能な Skills

はじめに

決済の受け付け

Billingモデル

カタログと価格設定

顧客と運用

UIと統合

インストール

スキルの使用

スキルの仕組み

他のツールとの比較

リソース

Skills Repository

MCP Server

Sentra

Discord Community

​概要

​利用可能な Skills

​はじめに

​決済の受け付け

​Billingモデル

​カタログと価格設定

​顧客と運用

​UIと統合

​インストール

​スキルの使用

​スキルの仕組み

​他のツールとの比較

​リソース

Skills Repository

MCP Server

Sentra

Discord Community

概要

利用可能な Skills

はじめに

決済の受け付け

Billingモデル

カタログと価格設定

顧客と運用

UIと統合

インストール

スキルの使用

スキルの仕組み

他のツールとの比較

リソース