Agent Skills

概要

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

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

Skills protocolをサポートするあらゆるAI agentでSkillsを使用できます。以下が含まれます:

Claude Code - AnthropicのCLIコーディングアシスタント
Codex CLI - OpenAIのCLIコーディングagent
Cursor - AIファーストのコードエディター
VS Code / GitHub Copilot - Agent Plugin経由
Kiro - SkillsをPowerとして読み込み
OpenCode - オープンソースのAIコーディング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

Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Kiro、またはOpenCodeを使用している場合、Dodo Agent Pluginによって17個すべてのSkillsと両方のMCP serversを一度にインストールできます。agentが関連するタスクを検出すると、Skillsは自動的に読み込まれます。agentごとのインストールコマンドについては、AI Coding Agents guideを参照してください。

あらゆるMCP-compatible agentで動作するuniversal 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

次に、個々の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は、指定したdirectoriesからSkillsを読み込みます。インストール済みpackagesをスキャンしないため、明示的なskills.paths entryが必要です。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"]
  }
}

Relative pathsはproject directoryを基準に解決されるため、packageはそのprojectのnode_modulesに存在している必要があります。Absolute pathも使用でき、その場合はlocal-install requirementを回避できます。

存在しないSkills pathはサイレントに無視されます — errorもwarningもありません。Skillsが実際に読み込まれたことを確認します:

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

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

Skillsの使用

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

Example prompt	Skill that loads
ベストプラクティスに従って、Dodo PaymentsをNext.js appに統合する方法を教えて	`dodo-best-practices`
Hono appにDodo Payments checkout route handlerを追加して	`framework-adapters`
決済のテストと本番稼働までの手順を説明して	`testing-and-go-live`
SaaS product用のcheckout sessionを作成して	`checkout-integration`
free trialと複数のpricing tiersを備えたsubscription flowを実装して	`subscription-integration`
React Native appにアプリ内checkoutを追加して	`mobile-checkout`
paymentとsubscription events用の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%割引にするpromo codeを追加して	`discounts-and-promotions`
purchasing power parityを適用し、訪問者のlocal currencyで価格を表示して	`localized-pricing`
Customersがpayment methodsを管理できるself-service portalを提供して	`customer-management`
partial refundを発行し、disputeが開始されたらaccessを取り消して	`refunds-and-disputes`
BillingSDK componentsを使用したpricing pageを追加して	`billing-sdk`
Better Auth setupにDodo Paymentsを組み込んで	`better-auth-integration`

Skillsの仕組み

SkillsはAI assistantに以下を提供します:

Procedural Knowledge - feature実装のstep-by-step instructions
Code Templates - production-readyなcode patternsとsnippets
Best Practices - security、error handling、UXに推奨されるアプローチ
Context Awareness - Dodo Paymentsのさまざまなfeaturesがどのように連携するかの理解

AI assistantにfeatureの実装を依頼すると、関連するSkillを使用して以下を行います:

正しいimplementation approachを理解する
正確で動作するcodeを生成する
Dodo Paymentsのconventionsに従う
edge casesとerrorsを適切に処理する

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

他のToolsとの比較

Tool	Purpose	Best For
Agent Skills	AI assistantのknowledgeを強化	あらゆるMCP clientを使用したAI-assisted development
MCP Server	API operationsを実行	AI assistantsからのdirect API access
Sentra	Guided integration assistant	IDEでのinteractive billing integration

Resources

Skills Repository

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

MCP Server

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

Sentra

IDE向けのAI-powered billing assistant

Discord Community

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

概要

利用可能なSkills

はじめに

決済の受け付け

Billingモデル

CatalogとPricing

CustomersとOperations

UIとIntegrations

インストール

Skillsの使用

Skillsの仕組み

他のToolsとの比較

Resources

Skills Repository

MCP Server

Sentra

Discord Community

​概要

​利用可能なSkills

​はじめに

​決済の受け付け

​Billingモデル

​CatalogとPricing

​CustomersとOperations

​UIとIntegrations

​インストール

​Skillsの使用

​Skillsの仕組み

​他のToolsとの比較

​Resources

Skills Repository

MCP Server

Sentra

Discord Community

概要

利用可能なSkills

はじめに

決済の受け付け

Billingモデル

CatalogとPricing

CustomersとOperations

UIとIntegrations

インストール

Skillsの使用

Skillsの仕組み

他のToolsとの比較

Resources