Parse and stringify YAML with Result-returning errors that name the failing line.
npx skills add https://github.com/sergiodxa/monorepo --skill sdxc-yaml-sergiodxa
Please help me install this Agent Skill. Skill: sdxc-yaml Source: https://github.com/sergiodxa/monorepo/tree/main/.agents/skills/sdxc-yaml Command: npx skills add https://github.com/sergiodxa/monorepo --skill sdxc-yaml-sergiodxa
parse returns Result<unknown, YAMLParseError> where the error carries the line it stopped on, modeled after the built-in JSON object. - Result-based serialization: stringify returns Result<string, YAMLStringifyError> with the path to the offending value, following JSON.stringify semantics for toJSON, undefined, and circular structures. - Documented subset: Supports block mappings and sequences, plain and quoted scalars, flow collections, block scalars and comments; anchors, aliases, merge keys, tags and multi-document sources fail loudly by name. - Use Case: Read a config file or frontmatter block, and when the source is malformed, surface a message naming the line rather than catching an exception. ## Quick Start Add @sdxc/yaml as a workspace dependency and use its parse function to read a YAML config file into typed data with line-numbered error handling.High-intent search queries and answers about installing and using this skill.
Use the parse function from @sdxc/yaml, which returns Result<unknown, YAMLParseError> instead of throwing. Check the result with isFailure from @sdxc/result, and the error carries the line where parsing stopped.
Call stringify from @sdxc/yaml with the value and optional indent option, which defaults to 2. It returns Result<string, YAMLStringifyError> and follows JSON.stringify semantics for toJSON, undefined entries, and circular structures.
No. Anchors, aliases, merge keys, tags, and multi-document sources are outside the supported subset and produce named parse failures rather than being silently misread. The subset covers block mappings, sequences, scalars, flow collections, block scalars, and comments.
Parse returns unknown because text read from a file has no guaranteed shape. Pass the result to a Standard Schema validator to obtain a concrete type, and note that an empty or comment-only source reads as null.
The core schema has no timestamp type, so dates stay strings in both directions and must be validated and converted yourself. Stringify writes NaN and infinities as .nan, .inf, and -.inf, and fails on circular structures or bigint values.
warsgbValidate skill frontmatter and end-to-end loading from disk.
antonyfmunozValidate and parse unknown runtime inputs into typed values with Zod schemas.
causify-aiExtract key points from markdown chapters and write structured summaries to summary.md.
gahoccodeValidate YAML syntax and convert between YAML, JSON, TOML, and XML.