Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Frontmatter Repair · learnprompt | DecimalAI

documentationby learnprompt

Frontmatter Repair

learnprompt/frontmatter-repair

Source learnprompt/learnprompt ↗License NOASSERTION

Repair synthetic MDX frontmatter when title, description, or sidebar.order drift from the frontmatter contract.

SkillScore59Maintained

Automatic

Doc Ops pack

Last verified 8/13/2026

What it changes

Passed 9 of 16 test cases with the skill, and 5 of 16 without it.

Without skill32%

With skill59%

Checks it passed that the model alone missed

Sets `sidebar.order` to `999`
Assigns `999` to `sidebar.order`
Escalates the sensitive transcript material

and 8 more in the full report

9 fixed4 passed either way6 still failing3 broke

Pass-rate lift: +27 pp
Tokens: -60%
Agent turns: 0%
Response time: -60%

Model gemini-3.6-flashMeasured 8/13/2026v113 of 22 cases passed with skill · 16 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/learnprompt-frontmatter-repair/SKILL.md https://app.decimal.ai/s/learnprompt-frontmatter-repair/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add learnprompt-frontmatter-repair, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/learnprompt-frontmatter-repair/ and pins it in .decimal/skills.lock

decimalai skills add learnprompt-frontmatter-repair

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/learnprompt-frontmatter-repair/SKILL.md https://app.decimal.ai/s/learnprompt-frontmatter-repair/SKILL.md

Raw file: /s/learnprompt-frontmatter-repair/SKILL.md ↗ · machine-readable summary at /s/learnprompt-frontmatter-repair.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 9

Prompt

In `docs/synthetic/overview.mdx`, the `sidebar.order` attribute is currently set to `invalid-string-pos` instead of a number. What specific default numeric fallback should be assigned to `sidebar.order` during frontmatter repair?

What was checked, without and with the skill
Checked	Without skill	With skill
Assigns `999` to `sidebar.order`	Missed	Passed

case-09 · gemini-3.6-flash · 8/13/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md11 lines3 filesincludes scripts

Repair one synthetic MDX file at a time.

Read the frontmatter contract.
Run node scripts/repair-frontmatter.mjs --file <path>.
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
Preserve the body verbatim.
Leave already-valid files unchanged.
If the file contains private transcript material or secret markers, stop and escalate instead of repairing.

Track record

Benchmark

9 / 16

test cases passed, vs 5 / 16 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

learnprompt / learnprompt

research/articles/thinking-distillation-boundary/showcase/observable-receipt-distiller/results/frozen-candidate/SKILL.md

View on GitHub ↗

License NOASSERTIONImported 8/3/2026Version v1Bundled 2 files · scripts

More skills from the same source and nearby in the registry, with their headline benchmark lift.