Skip to content

fix(skills): repair SKILL.md YAML frontmatter parse error#1487

Merged
aadesh18 merged 1 commit into
devfrom
fix/skill-md-yaml-frontmatter
May 26, 2026
Merged

fix(skills): repair SKILL.md YAML frontmatter parse error#1487
aadesh18 merged 1 commit into
devfrom
fix/skill-md-yaml-frontmatter

Conversation

@aadesh18
Copy link
Copy Markdown
Collaborator

@aadesh18 aadesh18 commented May 26, 2026

What

The description field in skills/stack-auth/SKILL.md failed to parse as YAML, surfacing on GitHub as:

Error in user YAML: (): mapping values are not allowed in this context at line 2 column 338

Why

The description was an unquoted YAML scalar containing a colon-space sequence:

…live, canonical instructions for every Stack Auth surface, including the CLI**: **how to model users…

In YAML, : inside an unquoted scalar is parsed as a key/value mapping, which is illegal mid-value — hence "mapping values are not allowed in this context."

Fix

Wrapped the description value in single quotes. Single quotes (not double) because the string already contains embedded double quotes ("stack auth", "skill") but no apostrophes, so no escaping is needed.

Verified the frontmatter now parses cleanly — all 9 keys (name, description, version, author, tags, testingTypes, frameworks, languages, domains) load via yaml.safe_load.

Notes

  • One-line change, content of the description is unchanged.
  • The unrelated @stackframe/dashboard typecheck failure on this branch comes from a stale generated .next/dev/types/routes.d.ts build artifact and is not touched by this PR.

Summary by cubic

Fixes YAML frontmatter parsing in skills/stack-auth/SKILL.md by quoting the description, removing the “mapping values are not allowed in this context” error. Wrapped the description in single quotes to prevent the CLI: how... colon-space from being parsed as a mapping.

Written for commit b8866bd. Summary will update on new commits. Review in cubic

Summary by CodeRabbit

  • Documentation
    • Updated formatting in skill documentation to improve consistency.

Review Change Stack

… error

The description scalar contained an unquoted colon-space ("including the
CLI: how to model users"), which YAML interprets as a nested mapping,
breaking frontmatter parsing with "mapping values are not allowed in
this context." Wrap the value in single quotes (the string contains
embedded double quotes but no apostrophes).
Copilot AI review requested due to automatic review settings May 26, 2026 01:26
@vercel
Copy link
Copy Markdown

vercel Bot commented May 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
stack-auth-hosted-components Ready Ready Preview, Comment May 26, 2026 1:28am
stack-auth-mcp Ready Ready Preview, Comment May 26, 2026 1:28am
stack-auth-skills Ready Ready Preview, Comment May 26, 2026 1:28am
stack-backend Building Building Preview, Comment May 26, 2026 1:28am
stack-dashboard Ready Ready Preview, Comment May 26, 2026 1:28am
stack-demo Building Building Preview, Comment May 26, 2026 1:28am
stack-docs Building Building Preview, Comment May 26, 2026 1:28am
stack-preview-backend Building Building Preview, Comment May 26, 2026 1:28am
stack-preview-dashboard Building Building Preview, Comment May 26, 2026 1:28am

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 26, 2026

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 464eabbc-fe74-43c2-894b-ad6331533832

📥 Commits

Reviewing files that changed from the base of the PR and between ed54832 and b8866bd.

📒 Files selected for processing (1)
  • skills/stack-auth/SKILL.md

📝 Walkthrough

Walkthrough

The description front-matter field in skills/stack-auth/SKILL.md is updated to use single-quote wrapping for YAML string formatting consistency. The description text itself remains unchanged.

Changes

SKILL Metadata Formatting

Layer / File(s) Summary
YAML Front-Matter Description Quoting
skills/stack-auth/SKILL.md
The description field in SKILL.md front-matter is now wrapped in single quotes for consistent YAML string formatting.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~1 minute

Possibly related PRs

Poem

🐰 A quote so neat, a rabbit's treat!
Single marks now embrace the metadata sweet,
YAML aligned, consistency complete—
One tiny tweak, the formatting's elite! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the main change: fixing a YAML frontmatter parsing error in SKILL.md by quoting the description field.
Description check ✅ Passed The PR description is comprehensive and well-structured, explaining what the issue is, why it occurred, and how it was fixed. It goes beyond the template requirements.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/skill-md-yaml-frontmatter

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 26, 2026

Greptile Summary

This PR fixes a YAML frontmatter parse error in skills/stack-auth/SKILL.md caused by an unquoted description value containing a colon-space sequence (: ), which YAML interprets as a key-value mapping delimiter. Wrapping the value in single quotes is the correct fix since the string contains embedded double quotes but no apostrophes.

  • Wraps the description scalar in single quotes so the embedded : no longer triggers a YAML mapping-value parse error.
  • Content of the description is entirely unchanged; this is a pure syntax fix with no functional impact.

Confidence Score: 5/5

Safe to merge — one-line YAML quoting fix with no logic or content changes.

The change wraps an unquoted YAML scalar in single quotes to fix a well-understood parse error. The description content is byte-for-byte identical; only the quoting delimiters are added. There are no logic changes, no new dependencies, and no other files touched.

No files require special attention.

Important Files Changed

Filename Overview
skills/stack-auth/SKILL.md Single-line fix: wraps the unquoted YAML description value in single quotes to resolve a mapping-value parse error; content is unchanged.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["SKILL.md frontmatter loaded"] --> B{description quoted?}
    B -- "No (before fix)" --> C["YAML parser sees ': ' mid-scalar"]
    C --> D["❌ Parse error: mapping values not allowed in this context"]
    B -- "Yes (after fix)" --> E["Single-quoted scalar parsed correctly"]
    E --> F["✅ All 9 frontmatter keys load successfully"]
Loading

Reviews (1): Last reviewed commit: "fix(skills): quote SKILL.md description ..." | Re-trigger Greptile

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Fixes a YAML frontmatter parse error in the Stack Auth skill definition by quoting a description value that contains a : sequence, which YAML otherwise interprets as a mapping delimiter.

Changes:

  • Wrapped the description scalar in single quotes in skills/stack-auth/SKILL.md to make the frontmatter valid YAML.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@aadesh18 aadesh18 merged commit 2ab43e9 into dev May 26, 2026
30 of 39 checks passed
@aadesh18 aadesh18 deleted the fix/skill-md-yaml-frontmatter branch May 26, 2026 01:28
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