OpenCode SDK Development FAQs

Question 1

How does it ensure that custom tools are reliable?

Accepted Answer

The skill leverages Zod-based schema validation via the `tool.schema` API. This ensures that all arguments passed from the AI to your custom code are strictly validated for type safety, providing robust error handling and clear parameter descriptions for the model.

Question 2

What is the difference between a tool and a plugin in this ecosystem?

Accepted Answer

Tools are specific functional scripts (local or global) used for discrete tasks. Plugins are more comprehensive integrations that can register multiple tools and use event hooks to intercept messages, modify configurations, or handle real-time streaming data from the OpenCode server.

Question 3

What does the OpenCode SDK Development skill do?

Accepted Answer

This skill provides a comprehensive framework for developers to extend Claude's capabilities by building custom tools, plugins, and programmatic integrations. It covers everything from basic tool creation with TypeScript to complex plugin hook systems for modifying AI behavior.

Question 4

Where are custom OpenCode tools stored?

Accepted Answer

Project-specific tools are stored in the `.opencode/tool/` directory within your project, while global tools available to all projects are stored in `~/.config/opencode/tool/`. Files in these locations are automatically discovered and turned into usable AI commands.

Question 5

When should I use this skill?

Accepted Answer

You should use this skill when you need to create specialized workflows for Claude Code, such as custom file searchers, API integrators, or automated project management scripts. It is the go-to resource for anyone using @opencode-ai/sdk or @opencode-ai/plugin.

OpenCode SDK Development

OpenCode SDK Development

概要

主な機能

ユースケース

概要

主な機能

ユースケース