clarify skills access workflow and precedence#644
Merged
JeremyDev87 merged 1 commit intomasterfrom Feb 27, 2026
Merged
Conversation
Rewrite opencode-skills.md with verified behavior only: - Remove nonexistent /skill CLI command documentation - Remove unverified config: auto_skills, auto_suggest_skills - Correct skills.paths to options.skills_paths (verified in Crush) - Define clear precedence: MCP tools (primary) > native discovery (supplementary) - Document CRUSH_SKILLS_DIR environment variable - Add complete skills list (29 skills) categorized by mode - Reference Agent Skills spec (agentskills.io/specification) - Add OpenCode archived → Crush context note Update opencode.md Skills System section: - Add get_skill, list_skills, analyze_task, generate_checklist to MCP tools - Replace unverified config with verified options.skills_paths - Add note clarifying no /skill slash command exists Closes #611
JeremyDev87
added
documentation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
JeremyDev87
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
opencode-skills.mdwith verified behavior only, removing nonexistent/skillCLI command and unverified config options (auto_skills,auto_suggest_skills)opencode.mdSkills System section and Available MCP Tools listProblem
The OpenCode integration documented two different skill access mechanisms without defining precedence or verifying their existence (#611):
/skill <name>CLI command — does not exist in OpenCode/Crushget_skillMCP tool — works correctly across all platformsAdditionally, several config options were documented but unverified:
skills.paths→ actuallyoptions.skills_paths(corrected)auto_skills→ does not exist (removed)auto_suggest_skills→ does not exist (removed)Changes
packages/rules/.ai-rules/adapters/opencode-skills.md(full rewrite)/skillCLI command documentationauto_skills,auto_suggest_skillsconfig optionsskills.pathstooptions.skills_paths(verified in Crush source)CRUSH_SKILLS_DIRenvironment variablepackages/rules/.ai-rules/adapters/opencode.md(partial update)get_skill,list_skills,analyze_task,generate_checklistto Available MCP Tools/skillslash command existsVerification
/skill,auto_skills,auto_suggest_skillsin modified filesTest Plan
/skillcommand references remain inopencode-skills.mdauto_skills/auto_suggest_skillsreferences remain in adapter docs.ai-rules/skills/)opencode.mdMCP tools list includes all skill-related toolsCloses #611