Skip to content

fix(skill): valid YAML + ≤1024 description for ornn-agent-manual-cli frontmatter - #1186

Merged
chronoai-shining merged 1 commit into
developfrom
fix/skill-frontmatter-yaml
Jul 1, 2026
Merged

fix(skill): valid YAML + ≤1024 description for ornn-agent-manual-cli frontmatter#1186
chronoai-shining merged 1 commit into
developfrom
fix/skill-frontmatter-yaml

Conversation

@chronoai-shining

Copy link
Copy Markdown
Collaborator

Summary

Hotfix for a regression from #1183. The v1.4 description broke on skill ingest/refresh:

  1. Invalid YAML — unquoted plain scalar containing SKILLSET request: bundle; the : (colon-space) makes the yaml parser read a nested mapping → INVALID_FRONTMATTER. skip_validation doesn't help (YAML parse precedes format validation).
  2. Over cap — was ~1400 chars vs the .max(1024) cap at skillFrontmatter.ts:225.

Fix

Reworded the offending clause (colon → semicolon/comma) and trimmed to 993 chars, keeping the trigger-oriented content (skills + skillsets + plugin-export + ownership-transfer triggers all retained).

Verification

Ran the API's own yaml.parse + validateSkillFrontmatter on the fixed file:

✓ yaml.parse OK
✓ validateSkillFrontmatter OK  (description length: 993)

Docs-only (empty changeset); the skill is registry-sourced, not bundled into either image.

Fixes #1185. Regression from #1183.

…#1185)

The v1.4 description (#1183) was an unquoted YAML plain scalar containing
"SKILLSET request: bundle" — a ': ' colon-space makes the yaml parser read
a nested mapping, so ingest/refresh failed with INVALID_FRONTMATTER
("Nested mappings are not allowed in compact mappings"). skip_validation
does not bypass it — YAML parse precedes format validation. The value was
also ~1400 chars vs the schema's 1024 cap (skillFrontmatter.ts:225).

Reword the offending clause (colon → semicolon/comma) and trim to 993
chars while keeping the trigger-oriented content. Verified with the API's
own yaml.parse + validateSkillFrontmatter (both pass).

Fixes #1185. Regression from #1183.
@chronoai-shining
chronoai-shining merged commit 579a436 into develop Jul 1, 2026
17 checks passed
@chronoai-shining
chronoai-shining deleted the fix/skill-frontmatter-yaml branch July 1, 2026 08:16
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.

[Bug] ornn-agent-manual-cli v1.4 frontmatter fails YAML parse (colon in description) + over 1024 cap

1 participant