skills.rest
cajias
cajiasCOMMUNITY
Explore all skills by this author →
GitHub

cc-slash-command-argument-hint-yaml

Quote argument-hint placeholders in Claude Code slash command frontmatter to fix YAML parsing.

Updated Nov 18, 2025
Search Tags:#claude code#plugin#yaml#slash command#frontmatter#argument-hint
One-click install
npx skills add https://github.com/cajias/claude-skills --skill cc-slash-command-argument-hint-yaml
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cc-slash-command-argument-hint-yaml
Source: https://github.com/cajias/claude-skills/tree/main/plugins/cc-plugin-authoring/skills/cc-slash-command-argument-hint-yaml
Command: npx skills add https://github.com/cajias/claude-skills --skill cc-slash-command-argument-hint-yaml

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and fix Claude Code slash command frontmatter that breaks YAML parsing when argument-hint values are written with unquoted bracketed placeholders, causing commands to disappear or validation tests to fail.

Core Features & Use Cases

  • YAML parse troubleshooting: Identifies when command frontmatter fails due to flow-sequence syntax or malformed placeholder formatting.
  • Slash command recovery: Restores commands that do not appear in Claude Code help after installation because their frontmatter could not be loaded.
  • Marketplace validation support: Explains why downstream tests may report missing fields even when the real issue is an unreadable frontmatter block.
  • Safe correction pattern: Recommends quoting argument-hint values as a single string so placeholders remain visible without breaking YAML.

Quick Start

Use this skill to inspect a slash command frontmatter block with bracketed argument-hint placeholders and rewrite it so Claude Code can parse and load the command correctly.

Frequently Asked Questions about cc-slash-command-argument-hint-yaml

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do my Claude Code slash commands disappear from help after installation?▼

Commands disappear when YAML frontmatter fails to parse because unquoted bracketed argument-hint values are interpreted as flow sequences. Quoting the argument-hint text as a YAML scalar forces the parser to treat placeholder brackets as plain characters.

How do I fix YAML parsing errors in Claude Code plugin command frontmatter?▼

Fix YAML parsing errors by quoting argument-hint values as a single YAML scalar string. This ensures the parser treats bracketed placeholders as plain characters rather than malformed flow sequences, restoring command visibility in Claude Code.

What causes marketplace validation tests to report missing fields in slash command files?▼

Validation tests report missing fields when the frontmatter block is unreadable due to YAML parse failures. The root cause is often unquoted bracketed argument-hint placeholders breaking the parser, not actually missing fields.

When do I need to quote argument-hint placeholders in YAML frontmatter?▼

Quote argument-hint placeholders whenever they contain bracketed values. Without quotes, the YAML parser interprets brackets as flow sequence delimiters, causing frontmatter parsing to fail and commands to silently disappear from Claude Code help output.

How does writing argument-hint values as unquoted brackets break YAML frontmatter loading?▼

Unquoted brackets trigger YAML flow-sequence parsing, treating placeholder syntax like [file] as a list instead of a string. This malformed structure causes the entire frontmatter block to fail loading, making the slash command unavailable in Claude Code.

Related Skills

Explore More Software Engineering Skills→
jpoutrinjpoutrin
14

create-command

Create Claude Code slash commands with YAML frontmatter and metadata.

Community
Intermediate
pr-pmpr-pm
121

creating-claude-commands

Generate Claude Code slash commands with correct frontmatter and structure.

Community
Basic
henmessihenmessi
1

Command Development

Create Claude Code slash commands with YAML frontmatter and dynamic arguments.

Community
Advanced
greatSuminigreatSumini
434

slash-command-creator

Create Claude Code slash commands with YAML frontmatter and templates.

Community
Basic