repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

docs(pi): warn about yaml description quoting

3f2cac0bc08a40c8d5d8f1e1ad2a79c710bf82ec

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

pi/agent/skills/pi/references/skills.md

Modified
92 92 ## Frontmatter
94 +YAML gotcha: quote `description` whenever it contains `:`, `{}`, `[]`, `#`, or other YAML punctuation. Unquoted colons commonly break skill loading with `Nested mappings are not allowed in compact mappings`.
96 +Good:
98 +```yaml
99 +description: "Use for Git workflows: committing, rebasing, landing branches, or reviewing PRs."
100 +```
102 +Bad:
104 +```yaml
105 +description: Use for Git workflows: committing, rebasing, landing branches, or reviewing PRs.
106 +```
94 108 | Field | Required | Notes |
95 109 | -------------------------- | -------- | -------------------------------------------------------------------- |
96 110 | `name` | Yes | 1-64 chars, lowercase letters/numbers/hyphens, must match parent dir |