[MODEL] Skills: Claude presents incorrect arg:value syntax in examples

Description

When Claude presents skill invocation examples to users, it may incorrectly use CLI-style --flag value syntax instead of the correct arg:value colon notation. This happens because SKILL.md files contain CLI examples for the underlying scripts, and Claude conflates these with skill invocation syntax.

Environment

• Claude Code version: 2.1.31
• OS: macOS

Reproduction Steps

1. Create a skill that wraps a CLI tool (e.g., a Python script with argparse)

1. Document the CLI usage in SKILL.md:

## Workflow
Run the script:
``
python post.py message.md --channel general --schedule "monday 9:00"
``

1. Ask Claude to explain how to use the skill

1. Claude may present examples like:

``
/slack --channel general
/slack --dm alice
``

Expected Behavior

Claude should present skill invocation examples using the correct colon syntax:

/slack channel:general
/slack dm:alice schedule:"monday 9:00"

Actual Behavior

Claude conflates CLI script syntax (--arg value) with skill invocation syntax (arg:value), presenting incorrect examples to users.

Suggested Fix

Consider adding guidance in the skill development documentation to:

1. Clearly distinguish between skill invocation syntax and CLI script syntax
2. Provide example templates showing the correct colon format
3. Add a note in the skill metadata spec about proper example formatting

Additional Context

• Discovered while building a Slack posting skill that wraps a Python CLI script
• User had to correct Claude on the proper invocation syntax
• The skill worked correctly once invoked properly - this is purely a documentation/presentation issue