From 76d7a11585196d3a09a02ad5d7adc06f15321729 Mon Sep 17 00:00:00 2001 From: Dax Raad Date: Fri, 10 Jul 2026 11:23:13 -0400 Subject: [PATCH] docs: expand opencode skill guidance --- packages/core/src/plugin/skill/opencode.md | 25 ++++++++++++++++------ 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/packages/core/src/plugin/skill/opencode.md b/packages/core/src/plugin/skill/opencode.md index 6cc6dc5055..1fe1f4f48e 100644 --- a/packages/core/src/plugin/skill/opencode.md +++ b/packages/core/src/plugin/skill/opencode.md @@ -4,8 +4,12 @@ Use this guide as the starting point for work involving OpenCode itself. It covers the core concepts needed to configure and customize OpenCode, extend it with plugins, and build integrations with the OpenCode SDK, clients, and API. -Full documentation is available at . Consult -it when this overview does not contain enough detail for the task. +Full documentation is available at . This overview is +only an index of core concepts. Before answering a question about a topic below, +fetch the URL named in that section and use the full page as the source of +truth. Follow links from that page when the question needs more detail. Fetch + first when you need to discover the relevant +documentation page. ## [Configuration](https://v2.opencode.ai/config) @@ -48,11 +52,18 @@ V1 config files and `.opencode/` definitions are intended to remain compatible. The only intentional breaking changes are the server API and plugin API. Native V2 config uses more ergonomic shapes, but conversion is optional. When the user requests conversion, inspect the complete configuration, preserve behavior and -unrelated settings, and apply only the relevant migrations from the guide. If -the request includes a V1 plugin, explain that its API is not finalized and do -not attempt migration yet. Once the V2 plugin API is finalized, OpenCode should -be able to migrate most plugins. If non-API V1 functionality fails in V2, use -the `report` skill to file it as a compatibility bug. +unrelated settings, and apply only the relevant migrations from the guide. For +plugin migrations, fetch and follow both the migration guide and the full +[plugins guide](https://v2.opencode.ai/build/plugins). If non-API V1 +functionality fails in V2, use the `report` skill to file it as a compatibility +bug. + +## [Plugins](https://v2.opencode.ai/build/plugins) + +For questions about creating, configuring, loading, publishing, or migrating +plugins, fetch the full [plugins guide](https://v2.opencode.ai/build/plugins) +before answering. This includes questions about the Effect plugin API, hooks, +transforms, tools, plugin context capabilities, and package entrypoints. ## [Service](https://v2.opencode.ai/troubleshooting#check-the-background-service)