feat(skill): enable customize-opencode by default, link full schema#26899
Merged
Conversation
Flips OPENCODE_EXPERIMENTAL_CUSTOMIZE_SKILL on for every channel; set the env var to false to opt out. The unstable-channel default helper had no other users, so it goes away. Adds a 'Full schema reference' section at the top of the skill so the model knows to fetch https://opencode.ai/config.json for any field the skill body does not cover, instead of guessing.
Config is loaded once at startup and is not hot-reloaded, but the skill never said so. Add an 'Applying changes' section so the model will tell the user to quit and restart opencode after editing config, agents, skills, or plugins. Mirror that as a final bullet in 'When proposing edits'. While reviewing the file, fix a few smaller issues: - HTML comment referenced SKILL_NAME / SKILL_DESCRIPTION; the actual constants are CUSTOMIZE_OPENCODE_SKILL_NAME and CUSTOMIZE_OPENCODE_SKILL_DESCRIPTION. - Replace ambiguous 'or the field is not covered above' with 'in this skill' (the schema reference is at the top, not above the bullet). - Reword '$schema' paragraph from 'also' (mid-topic-shift) to 'Independently' for cleaner flow. - Tighten 'Full schema reference' intro with em-dashes.
kitlangton
force-pushed
the
worktree-customize-skill-config-link
branch
from
297bc2d to
bb769ba
Compare
Always register the built-in customize-opencode skill. The previous commit flipped the default on for every channel; this removes the opt-out env var entirely. Users with a local skill of the same name still override the built-in via the existing 'register before disk discovery' ordering. Tests filter '<built-in>' out of skill.all() results so disk-discovery assertions remain exact.
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
Follow-up to #26617.
OPENCODE_EXPERIMENTAL_CUSTOMIZE_SKILLon for every install channel. Set the env var tofalseto opt out. The skill has been on by default fordev/beta/localsince it landed — this just removes the channel gating. Dropped the unusedunstableDefault/UNSTABLE_CHANNELShelper.## Full schema referencesection at the top ofcustomize-opencode.mdso the model knows to fetch https://opencode.ai/config.json for any field the skill body does not cover, rather than guessing. The schema URL was already mentioned, but lower in the body and easy to miss; this surfaces it as the authoritative reference for fields the skill summary omits.Test plan
bun run typecheckinpackages/opencodeandpackages/corebun run test test/skillinpackages/opencode— 18/18 passOPENCODE_EXPERIMENTAL_CUSTOMIZE_SKILL=falsestill disables it