Skip to content

fix(plugin-dev): add missing descriptions to AskUserQuestion option examples#23930

Open
leszekszpunar wants to merge 1 commit intoanthropics:mainfrom
leszekszpunar:fix/interactive-commands-missing-descriptions
Open

fix(plugin-dev): add missing descriptions to AskUserQuestion option examples#23930
leszekszpunar wants to merge 1 commit intoanthropics:mainfrom
leszekszpunar:fix/interactive-commands-missing-descriptions

Conversation

@leszekszpunar
Copy link

Summary

  • Fix AskUserQuestion option examples in interactive-commands.md that were missing required description fields, causing skill-creator to crash with description.split is not a function
  • Three sections had options without descriptions: Pattern 2 (inline comma-separated format), Multi-Select Guidelines example, and Feature Selection common pattern
  • All options now use the correct bulleted format with parenthetical descriptions, consistent with the rest of the file and the AskUserQuestion tool schema

Fixes #23855

Details

The AskUserQuestion tool requires each option to have both label and description fields. The reference document interactive-commands.md is used by the skill-creator skill to learn how to construct interactive commands. When the skill followed the Pattern 2 example (which used bare comma-separated strings like options: Python, TypeScript, Go, Rust), it generated tool calls without description fields, causing the UI to crash on description.split("\n").

Changes

Pattern 2: Multiple Configuration Questions (primary fix)

  • Converted 4 inline comma-separated option lists to proper bulleted format with descriptions
  • Before: - options: Python, TypeScript, Go, Rust
  • After: each option on its own line with description, e.g. - Python (General-purpose, great for data and scripting)

Multi-Select Guidelines - "Good multi-select use" example

  • Added descriptions to Logging, Metrics, Alerts, Backups options

Common Patterns - Feature Selection

  • Added descriptions to Authentication, Authorization, Rate Limiting, Caching options

Test plan

  • Invoke document-skills:skill-creator and verify it no longer crashes when generating interactive commands
  • Verify the generated AskUserQuestion tool calls include description fields for all options
  • Confirm Pattern 2 examples render correctly in markdown

…xamples

Options in interactive-commands.md Pattern 2 used inline
comma-separated format without descriptions, causing
skill-creator to crash with 'description.split is not a function'
when generating AskUserQuestion tool calls from these patterns.

Convert all bare option lists to bulleted format with
parenthetical descriptions, consistent with the AskUserQuestion
tool schema and the rest of the reference document.

Fixes anthropics#23855
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.

Bug: document-skills:skill-creator crashes with 'description.split is not a function'

2 participants