Skip to content

a5c-ai/babysitter / library/methodologies/gsd/skills/frontmatter-parsing

frontmatter-parsing

Verified

YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.

FileKindSize
README.mdmarkdown1.7 KB
SKILL.mdskill md7.0 KB
# frontmatter-parsing

YAML frontmatter parsing and manipulation for GSD markdown documents.

## Quick Start

All GSD documents use YAML frontmatter for metadata. This skill reads, writes, and queries frontmatter fields.

### Parse Frontmatter

Read a file and extract the YAML block between `---` delimiters at the top.

### Update a Field

```
Before: status: planned
After:  status: executed
```

Only the target field line is modified; body content is untouched.

### Query by Field

Find all PLAN.md files where `wave: 1`:

```bash
# Searches .planning/ recursively for files with matching frontmatter
```

## Examples

### Plan Frontmatter

```yaml
---
status: planned
phase: 72
plan_number: 1
wave: 1
depends_on: []
files_modified:
  - src/auth/oauth.ts
  - src/auth/tokens.ts
task_count: 4
created: 2026-03-02
---
```

### State Frontmatter

```yaml
---
last_updated: 2026-03-02T14:30:00Z
session_count: 12
current_milestone: v1.0
---
```

### Batch Status Update

Update all plans in a phase to "executed" status after phase completion.

## Troubleshooting

### YAML parse errors
- Check for missing colons after field names
- Ensure arrays use consistent syntax (inline or block)
- Verify no tabs are used (YAML requires spaces)
- Check for unquoted special characters in values

### Field update changes wrong line
- Ensure the field is within the frontmatter block (between `---` delimiters)
- If the same text appears in the body, provide more context for uniqueness
- Use `Edit` with surrounding lines for disambiguation

### Query returns no results
- Verify the field name and value match exactly (case-sensitive)
- Check that files in the directory actually have frontmatter
- Ensure the search is recursive if files are in subdirectories
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall