Inject Titles

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