mosaicstack/agent-skills
12
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

fix: quote SKILL.md descriptions containing colons (silent skill-load failure) #3

Merged
Ghost merged 1 commits from fix/skill-frontmatter-yaml-colons into main 2026-08-11 22:53:48 +00:00
Conversation 0 Commits 1 Files Changed 2
+2 -2
Ghost commented 2026-08-11 22:01:59 +00:00
Copy Link
Copy Source

What

mosaic-deploy and mosaic-woodpecker never load: their frontmatter description: values contain an inner : (...projects: push branch..., CI URL: https://...), which is invalid YAML (mapping values are not allowed here). Every loader that parses the frontmatter (packages/mosaic/src/skills/catalog.ts in mosaicstack/mosaic, and harness skill scanners) throws on parse and drops the skill with no message — the skill is simply absent from the catalog.

Fix: quote the two description values. No content change.

Verification

  • yaml.safe_load on the frontmatter: fails on both files before, parses all six mosaic-* SKILL.md after.
  • Applied the same quoting to a deployed ~/.config/mosaic/skills/ copy: both skills immediately registered in a live harness session.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Lqpn98b2DeiWd29oL7WhR7

## What `mosaic-deploy` and `mosaic-woodpecker` never load: their frontmatter `description:` values contain an inner `: ` (`...projects: push branch...`, `CI URL: https://...`), which is invalid YAML (`mapping values are not allowed here`). Every loader that parses the frontmatter (`packages/mosaic/src/skills/catalog.ts` in mosaicstack/mosaic, and harness skill scanners) throws on parse and drops the skill with no message — the skill is simply absent from the catalog. Fix: quote the two description values. No content change. ## Verification - `yaml.safe_load` on the frontmatter: fails on both files before, parses all six `mosaic-*` SKILL.md after. - Applied the same quoting to a deployed `~/.config/mosaic/skills/` copy: both skills immediately registered in a live harness session. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Lqpn98b2DeiWd29oL7WhR7
Ghost added 1 commit 2026-08-11 22:02:00 +00:00
fix: quote SKILL.md descriptions containing colons — unquoted inner ':' is invalid YAML and the skill silently fails to load b4cfa7d243 
mosaic-deploy and mosaic-woodpecker both have a ': ' inside the description
value ('...projects: push branch...' and 'CI URL: https://...'). YAML
rejects a mapping value there ('mapping values are not allowed here'), the
frontmatter parse throws, and every catalog/harness loader that parses the
frontmatter drops the skill without a message — the skill is simply absent.

Verified: yaml.safe_load fails on both files before this change and parses
all six mosaic-* SKILL.md files after it; both skills register in a live
harness session once quoted.

Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Lqpn98b2DeiWd29oL7WhR7
Ghost merged commit a0dd77cd91 into main 2026-08-11 22:53:48 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
code-be-01 (Mosaic fleet seat code-be-01) code-be-02 (Mosaic fleet seat code-be-02) code-infra-01 (Mosaic fleet seat code-infra-01) fargo jason.woltje (Jason Woltje) rev-code-01 rev-code-02 rev-security-01 rev-security-02 rev-security-03 (Mosaic fleet seat rev-security-03) veronica (Mosaic fleet seat veronica) vision
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/agent-skills#3