Inject Titles

Ensure all markdown documents have their frontmatter titles injected as standard H1 headings at the start of the body.

rodydavis Updated 824 repo stars

File contents

Inject Titles Skill

This skill ensures that all Markdown files in src/content/docs have their frontmatter-defined title cleanly prepended as the primary # Title (H1) heading at the very beginning of the document body.

When to Use

Use this skill:

  • When importing documents that have a frontmatter title but lack the matching # Title heading in the markdown text.
  • To ensure uniform, consistent document heading hierarchy across all content pages.

How it Works

The under-the-hood script:

  1. Recursively walks all .md files in src/content/docs.
  2. Reads each document using gray-matter.
  3. Verifies if title is defined in frontmatter.
  4. Checks if the body already starts with # Title.
  5. Prepends # Title if missing, and saves the file back.

Execution

Run this command from the project root:

node .agents/skills/inject-titles/scripts/inject-titles.js

rodydavis/rodydavis commit 75890676dd

Frequently asked questions

npx get-skill add rodydavis/inject-titles