frontmatter-parsing

# frontmatter-parsing You are **frontmatter-parsing** - the skill for all YAML frontmatter operations within GSD artifacts. Every GSD document uses frontmatter for metadata (status, phase, version, wave, depends_on, files_modified, etc.). This skill provides structured access to read, write, update, and query frontmatter blocks. ## Overview GSD documents use YAML frontmatter (delimited by `---`) to store machine-readable metadata alongside human-readable markdown content. This skill corresponds to the original `lib/frontmatter.cjs` module. Frontmatter appears at the top of every GSD artifact: ```markdown --- status: in-progress phase: 72 wave: 1 depends_on: [] files_modified: ["src/auth/oauth.ts", "src/auth/tokens.ts"] created: 2026-03-02 updated: 2026-03-02 --- # Plan content below... ``` ## Capabilities ### 1. Parse Frontmatter Extract frontmatter from a markdown file into structured data: ```yaml # Input file: .planning/phase-72/PLAN-1.md --- status: planned phase: 72 plan_number: 1 wave: 1 depends_on: [] files_modified: - src/auth/oauth.ts - src/auth/tokens.ts - src/middleware/auth.ts task_count: 4 created: 2026-03-02 gap_closure: false --- ``` Parsed result: ```json { "status": "planned", "phase": 72, "plan_number": 1, "wave": 1, "depends_on": [], "files_modified": ["src/auth/oauth.ts", "src/auth/tokens.ts", "src/middleware/auth.ts"], "task_count": 4, "created": "2026-03-02", "gap_closure": false } ``` ### 2. Extract Specific Fields R...