frontmatter-guard

Solid

Injects the canonical vault frontmatter schema snippet into agent prompts before any vault-write task, preventing malformed YAML frontmatter in Obsidian notes. <example>Context: wave-executor is about to dispatch a vault-mirror agent that writes learning notes under ~/Projects/vault/40-learnings/. user: "dispatch vault-write agent" assistant: "Injecting frontmatter-guard snippet into agent prompt (vault scope detected). Required fields: id, type, created, updated. Enum type: note|daily|project|person|reference|idea|learning|session." <commentary>The wave-executor pre-dispatch hook calls detectVaultTaskScope() — the fileScope contains /Projects/vault/40-learnings/ so the guard triggers and the snippet is prepended to the agent system prompt.</commentary></example>

Code & Development 50 stars 7 forks Updated today MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
57
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
23
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# frontmatter-guard > **Portable mirror — generated, do not edit.** The canonical skill body lives at > [`skills/frontmatter-guard/SKILL.md`](../../../skills/frontmatter-guard/SKILL.md); read that file for the full instructions. > This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that > discover skills under `.agents/skills/` can find and route to the skill. > > Regenerate with `node scripts/generate-agents-skills.mjs`.

Details

Author
Kanevry
Repository
Kanevry/session-orchestrator
Created
5 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

vault-sync

Use when you need to validate the Meta-Vault's Markdown frontmatter and wiki-link integrity before closing a session or after vault edits. Runs as a hard gate at session-end Phase 1 — blocks close if any `.md` file fails the Zod frontmatter schema or has dangling `[[wiki-links]]`. Supports three modes: `hard` (blocks on errors), `warn` (reports without blocking), `off` (skip). Reads `vault-sync.*` from Session Config; respects per-vault exclude globs from `CLAUDE.md`. Triggers: "vault validation failed at session close", "fix vault frontmatter errors", "check vault wiki-links", "why is session-end blocked by vault-sync". <example>Context: session-end Phase 1 quality gate, vault-sync.enabled=true, vault-sync.mode="hard". user: "/close" assistant: "vault-sync found 2 frontmatter errors in vault/40-learnings/ml-notes.md — missing required `id` field. Fixing before close."</example>

50 Updated today
Kanevry
Code & Development Solid

vault-mirror

Use when you need to populate the Meta-Vault with machine-generated notes derived from session-orchestrator JSONL records. Converts entries from `.orchestrator/metrics/sessions.jsonl` and `.orchestrator/metrics/learnings.jsonl` into vault-conformant Markdown under `50-sessions/` and `40-learnings/`. Called automatically at session-end Phase 3.7 and after evolve Phase 3.5 — only when `vault-integration.enabled=true` and `vault-integration.mode != "off"`. Idempotent: re-runs safely; skips hand-authored notes. Triggers: "mirror to vault", "sync session notes to vault", "write learning notes to vault", "vault-mirror failed at session close". <example>Context: session-end is finalizing, vault-integration.mode is "warn". user: "/close" assistant: "Running vault-mirror to write 50-sessions/session-2026-05-17.md from the closing session record — 1 created, 0 skipped."</example>

50 Updated today
Kanevry
Code & Development Listed

obsidian-vault

Vault conventions and formats for writing to the Obsidian vault — note frontmatter, session-log and journal snippets, evergreen project notes, .base database views, ADR format, and clipping URLs into the vault. Use when creating or editing vault notes, session logs, ADRs, or .base files. Defers `obsidian` CLI syntax and defuddle flags to the obsidian:obsidian-cli and obsidian:defuddle skills.

0 Updated 2 weeks ago
pyang2045