fix(paper2assets): make SKILL.md description valid YAML for strict parsers - #27
Open
YQGHL wants to merge 1 commit into
Open
fix(paper2assets): make SKILL.md description valid YAML for strict parsers#27YQGHL wants to merge 1 commit into
YQGHL wants to merge 1 commit into
Conversation
…rsers The frontmatter description was a single plain scalar containing 'metadata.json: title / authors / ...'. The colon-space sequence makes strict YAML parsers treat it as a nested mapping inside a compact mapping, raising 'Nested mappings are not allowed in compact mappings'. Claude Code and Codex tolerate this, but tools validating against the Agent Skills spec (e.g. Pi) fail to load the skill. Convert the description to a folded block scalar (>) with identical content, so colons stay literal.
YQGHL
force-pushed
the
fix/paper2assets-yaml-frontmatter
branch
from
August 5, 2026 17:37
38a7836 to
f29d726
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The
descriptionfield inpaper2assets/SKILL.mdis a single plain scalar containingmetadata.json: title / authors / .... The colon-space sequence is interpreted by strict YAML parsers as a nested mapping inside a compact mapping:Claude Code and Codex tolerate this (lenient parsing), but tools that validate against the Agent Skills spec — such as Pi — refuse to load the skill.
Fix
Convert
descriptionto a folded block scalar (>) with identical content. Colons inside a block scalar are literal, sometadata.json: title / ...no longer parses as a nested mapping.Impact