Skip to content

fix(skills): quote bump-version description — unquoted colon breaks YAML frontmatter - #3584

Open
iphixit wants to merge 1 commit into
iOfficeAI:mainfrom
iphixit:fix/bump-version-skill-yaml
Open

fix(skills): quote bump-version description — unquoted colon breaks YAML frontmatter#3584
iphixit wants to merge 1 commit into
iOfficeAI:mainfrom
iphixit:fix/bump-version-skill-yaml

Conversation

@iphixit

@iphixit iphixit commented Jul 14, 2026

Copy link
Copy Markdown

Problem

.claude/skills/bump-version/SKILL.md has an unquoted description value containing a colon:

description: Use when bumping the AionUi version: query AionCore release, verify artifacts, ...

A : (colon-space) inside a plain YAML scalar is not valid. The frontmatter fails to parse:

yaml.scanner.ScannerError: mapping values are not allowed here

So the skill's frontmatter can't be read and the skill doesn't register.

Reproduce (on current main)

python3 -c "import yaml, pathlib; yaml.safe_load(
  pathlib.Path('.claude/skills/bump-version/SKILL.md').read_text().split('---')[1])"

Fails on main (verified against 0fea1eb / v2.1.34). Passes with this change.

Fix

Wrap the description in double quotes. No behaviour change — the string content is byte-identical. It's purely a YAML quoting fix.

Scope

Only this skill is affected. I checked the other three under .claude/skills/ (architecture, i18n, testing) — all parse cleanly and are untouched by this PR.


Found while reading the source as a downstream user. Thanks for AionUi.

…AML parse

The `description` field contains "version:" — an unquoted colon-space
inside a plain YAML scalar, which is invalid. `yaml.safe_load` fails with
"mapping values are not allowed here", so the skill's frontmatter cannot be
parsed and the skill fails to register.

Reproduce:
    python3 -c "import yaml,pathlib; yaml.safe_load(
      pathlib.Path('.claude/skills/bump-version/SKILL.md').read_text().split('---')[1])"

Fix: wrap the description in double quotes. No behaviour change; the string
is identical. The other three skills in .claude/skills/ are unaffected.
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.

1 participant