Bug Description
The two plugin commands (create-plugin.md and create-marketplace.md) have frontmatter inconsistencies that deviate from documented best practices in the command-development skill and official Claude Code plugin documentation.
Issues Found
1. create-plugin.md - argument-hint has unnecessary quotes
File: plugins/plugin-dev/commands/create-plugin.md line 3
Current:
argument-hint: "[plugin-description]"
Should be:
argument-hint: [plugin-description]
Rationale: The skill examples (SKILL.md:187) and official docs show argument-hint: [message] without quotes around the placeholder.
2. create-marketplace.md - description exceeds recommended length
File: plugins/plugin-dev/commands/create-marketplace.md line 2
Current: (86 characters)
description: Guided end-to-end marketplace creation workflow with plugin organization and validation
Should be: (~47 characters)
description: Create plugin marketplaces with guided workflow
Rationale: The command-development skill (SKILL.md:133) states: "Best practice: Clear, actionable description (under 60 characters)"
3. create-marketplace.md - argument-hint doesn't use bracket notation
File: plugins/plugin-dev/commands/create-marketplace.md line 3
Current:
argument-hint: Optional marketplace description
Should be:
argument-hint: [marketplace-description]
Rationale: Official docs and all skill examples use [placeholder] bracket notation. "Optional" should be communicated differently (e.g., in the description or command body).
4. create-marketplace.md - Missing Edit tool for consistency
File: plugins/plugin-dev/commands/create-marketplace.md line 4
Current:
allowed-tools: ["Read", "Write", "Grep", "Glob", "Bash", "TodoWrite", "AskUserQuestion", "Skill", "Task"]
Should include Edit:
allowed-tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash(mkdir:*)", "TodoWrite", "AskUserQuestion", "Skill", "Task"]
Rationale: create-plugin.md includes Edit in its allowed-tools. Both commands may need to edit existing files during their workflows. Consistency between commands in the same plugin improves maintainability.
Steps to Reproduce
- Read
plugins/plugin-dev/commands/create-plugin.md
- Read
plugins/plugin-dev/commands/create-marketplace.md
- Compare frontmatter against
plugins/plugin-dev/skills/command-development/SKILL.md best practices
- Note the inconsistencies listed above
Expected Behavior
Both commands should follow consistent frontmatter conventions that align with:
- The command-development skill's documented best practices
- Official Claude Code plugin command documentation
- Each other (consistency within the same plugin)
Actual Behavior
Frontmatter fields use inconsistent formats and some deviate from documented best practices.
Command Used
N/A - This is a code quality/consistency issue, not a runtime bug.
Environment
- Plugin Version: 0.1.0
- Files affected:
plugins/plugin-dev/commands/create-plugin.mdplugins/plugin-dev/commands/create-marketplace.md
Additional Context
These issues were found during a comprehensive review of the plugin commands against:
All four issues can be fixed in a single PR as they're related frontmatter consistency improvements.
Bug Description
The two plugin commands (
create-plugin.mdandcreate-marketplace.md) have frontmatter inconsistencies that deviate from documented best practices in thecommand-developmentskill and official Claude Code plugin documentation.Issues Found
1.
create-plugin.md- argument-hint has unnecessary quotesFile:
plugins/plugin-dev/commands/create-plugin.mdline 3Current:
Should be:
Rationale: The skill examples (SKILL.md:187) and official docs show
argument-hint: [message]without quotes around the placeholder.2.
create-marketplace.md- description exceeds recommended lengthFile:
plugins/plugin-dev/commands/create-marketplace.mdline 2Current: (86 characters)
Should be: (~47 characters)
Rationale: The command-development skill (SKILL.md:133) states: "Best practice: Clear, actionable description (under 60 characters)"
3.
create-marketplace.md- argument-hint doesn't use bracket notationFile:
plugins/plugin-dev/commands/create-marketplace.mdline 3Current:
Should be:
Rationale: Official docs and all skill examples use
[placeholder]bracket notation. "Optional" should be communicated differently (e.g., in the description or command body).4.
create-marketplace.md- Missing Edit tool for consistencyFile:
plugins/plugin-dev/commands/create-marketplace.mdline 4Current:
Should include
Edit:Rationale:
create-plugin.mdincludesEditin its allowed-tools. Both commands may need to edit existing files during their workflows. Consistency between commands in the same plugin improves maintainability.Steps to Reproduce
plugins/plugin-dev/commands/create-plugin.mdplugins/plugin-dev/commands/create-marketplace.mdplugins/plugin-dev/skills/command-development/SKILL.mdbest practicesExpected Behavior
Both commands should follow consistent frontmatter conventions that align with:
Actual Behavior
Frontmatter fields use inconsistent formats and some deviate from documented best practices.
Command Used
N/A - This is a code quality/consistency issue, not a runtime bug.
Environment
plugins/plugin-dev/commands/create-plugin.mdplugins/plugin-dev/commands/create-marketplace.mdAdditional Context
These issues were found during a comprehensive review of the plugin commands against:
plugins/plugin-dev/skills/command-development/SKILL.mdAll four issues can be fixed in a single PR as they're related frontmatter consistency improvements.