Frontmatter Repair

Repair synthetic MDX frontmatter when title, description, or sidebar.order drift from the frontmatter contract. Use for files that follow the same observable patterns proven in the receipts; do not use on private transcripts, secret-bearing material, or arbitrary YAML.

learnprompt b3f8bf6 3 files · 6.2 KB Updated

File contents

Repair one synthetic MDX file at a time.

  1. Read the frontmatter contract.
  2. Run node scripts/repair-frontmatter.mjs --file <path>.
  3. Only repair rules proven by the receipts:
    • title from the first H1
    • description from the opening paragraph’s first sentence
    • invalid sidebar.order to 999
  4. Preserve the body verbatim.
  5. Leave already-valid files unchanged.
  6. If the file contains private transcript material or secret markers, stop and escalate instead of repairing.

learnprompt/learnprompt/tree/main/research/articles/thinking-distillation-boundary/showcase/observable-receipt-distiller/results/live-candidate commit b3f8bf6647

Frequently asked questions

npx skillmds@latest add learnprompt/frontmatter-repair