Skip to content

[BUG]: customize-opencode skill has wrong/missing command docs #32717

Description

@Grantmartin2002

Description

The built-in customize-opencode skill has a few problems around commands:

  • The command example uses prompt, but the schema wants template. If you follow it, opencode won't start (ConfigInvalidError: Missing key ... ["template"]).
  • It never mentions that commands can live as .opencode/command/<name>.md files, so the agent just inlines everything into opencode.json.
  • The skill's own description doesn't list commands, so it sometimes doesn't load when you ask for a slash command.

Plugins

N/A

OpenCode version

v1.17.7 (also on dev)

Steps to reproduce

  1. Open a project with no opencode.json.
  2. Ask the agent to add a /hello command.
  3. It follows the skill and writes prompt instead of template.
  4. Restart opencode, startup fails with ConfigInvalidError: Missing key at ["command"]["hello"]["template"].

Screenshot and/or share link

N/A

Operating System

macOS

Terminal

Terminal

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions