Skip to content

fix(reporting,development): quote SKILL.md descriptions containing colons#4

Merged
datbth merged 1 commit into
mainfrom
fix/quote-skill-descriptions-with-colons
Apr 28, 2026
Merged

fix(reporting,development): quote SKILL.md descriptions containing colons#4
datbth merged 1 commit into
mainfrom
fix/quote-skill-descriptions-with-colons

Conversation

@chinh-dm-holistics
Copy link
Copy Markdown
Contributor

@chinh-dm-holistics chinh-dm-holistics commented Apr 27, 2026

Problem

The working-in-reporting and working-in-development skills are flagged invalid by skill loaders (e.g ampcode, opencode) that strictly validate YAML frontmatter.

CleanShot 2026-04-27 at 23 39 33

Getting this error when running "amp skill list":

CleanShot 2026-04-27 at 23 40 22

Both descriptions contain an unquoted colon followed by a space:

description: Use Holistics … Tooling includes: MCP tools such as `generate_viz`, …
                                       ^ here

In YAML, an unquoted scalar that contains : is parsed as a new mapping key, which corrupts the frontmatter. As a result, both skills fail to load.

Fix

  • Wrap both descriptions in double quotes so the colon is preserved as part of the string.
  • Bumped both plugins to 0.0.4 via pnpm bump (marketplace bumped to 0.0.6) per DEVELOPMENT.md.

…ns containing colons

The 'working-in-reporting' and 'working-in-development' skills had
unquoted descriptions containing 'Tooling includes: ...' which breaks
YAML frontmatter parsing because of the colon followed by a space.
This caused both skills to be flagged as invalid by skill loaders that
strictly validate frontmatter (e.g. Amp).

Fixes:
- Wrap both descriptions in double quotes so the colon is preserved
- Rephrase to avoid an unquoted colon entirely
- Fix typo 'effeciently' -> 'efficiently'
- Bump holistics-reporting and holistics-development to 0.0.4
  (marketplace -> 0.0.6 via pnpm bump)
@datbth datbth merged commit 689105e into main Apr 28, 2026
3 checks passed
@datbth datbth deleted the fix/quote-skill-descriptions-with-colons branch April 28, 2026 10:17
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.

2 participants