Skip to content

docs: add global installation guide for OpenCode#126

Open
juanitourquiza wants to merge 1 commit intoaddyosmani:mainfrom
juanitourquiza:feat/opencode-global-install
Open

docs: add global installation guide for OpenCode#126
juanitourquiza wants to merge 1 commit intoaddyosmani:mainfrom
juanitourquiza:feat/opencode-global-install

Conversation

@juanitourquiza
Copy link
Copy Markdown

OpenCode's built-in skill tool only recognizes a small set of natively registered skills. The skills in this repo are not automatically discoverable by that tool, making the per-workspace setup the only option.

This adds a 'Global Installation (All Projects)' section to the OpenCode setup guide that explains how to use the skills across all projects by:

  1. Copying skills to ~/.agents/skills/
  2. Creating a global ~/.claude/AGENTS.md with intent mapping
  3. Referencing it from ~/.claude/CLAUDE.md (loaded in every session)

The agent then reads skill definitions on-demand via the read tool instead of the skill tool.

Also updates the README to mention both workspace-local and global options in the OpenCode quick-start summary.

OpenCode's built-in skill tool only recognizes a small set of natively
registered skills. The skills in this repo are not automatically
discoverable by that tool, making the per-workspace setup the only
option.

This adds a 'Global Installation (All Projects)' section to the
OpenCode setup guide that explains how to use the skills across all
projects by:

1. Copying skills to ~/.agents/skills/
2. Creating a global ~/.claude/AGENTS.md with intent mapping
3. Referencing it from ~/.claude/CLAUDE.md (loaded in every session)

The agent then reads skill definitions on-demand via the read tool
instead of the skill tool.

Also updates the README to mention both workspace-local and global
options in the OpenCode quick-start summary.
@juanitourquiza juanitourquiza force-pushed the feat/opencode-global-install branch from 4c10353 to fac2473 Compare May 7, 2026 15:06
@ntcho ntcho mentioned this pull request May 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant