Skip to content

docs(skill): document project-level external skill auto-discovery - #48976

Open
holny wants to merge 1 commit into
anomalyco:devfrom
holny:skill-docs-scopes
Open

holny wants to merge 1 commit into
anomalyco:devfrom
holny:skill-docs-scopes

Conversation

@holny

@holny holny commented Sep 14, 2026

Copy link
Copy Markdown

Issue for this PR

Closes #41850

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

The "Where files live" table in the customize-opencode skill claimed external skills are only picked up from the home directory, but discoverSkills (packages/opencode/src/skill/index.ts) also walks up from the cwd to the worktree root scanning .claude/skills and .agents/skills. This splits the external row into project and global entries, clarifies that skills.paths is only needed for non-default locations, and notes both disable flags apply to the two scopes.

How did you verify your code works?

Checked the loader on current dev (both scan scopes at packages/opencode/src/skill/index.ts) and ran bun test test/plugin/skill.test.ts in packages/core plus bun test test/skill/ in packages/opencode — all green.

Screenshots / recordings

Not a UI change.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

The 'Where files live' table only listed the home-directory external skill
paths, but discoverSkills also scans .claude/skills and .agents/skills from
the cwd up to the worktree root. Split the row into project and global
entries, note the disable flags cover both scopes, and clarify that
skills.paths is only needed for non-default locations.

Closes anomalyco#41850
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.

docs(skill): customize-opencode table omits project-level .claude/skills and .agents/skills auto-discovery

1 participant