# Inject Titles

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

- Skill: `rodydavis/inject-titles` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add rodydavis/inject-titles`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rodydavis/inject-titles/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: rodydavis (https://skillmd.com/u/rodydavis)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rodydavis/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:

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