Database Schema Formatter skill for Claude and Codex
Normalises raw table definitions, whether DDL dumps, ORM models, or notes, into one consistent Markdown schema reference with aligned tables, keys, and a…
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when raw DDL, ORM models, or hand-written table notes should be reformatted into a clean, consistent Markdown or HTML schema reference with a version header. Do not use for writing explanatory documentation with column meanings and join guidance, designing tables, or checking a schema for problems. Related topics: coding, database.
What it will ask you for
- Table definitions (longer free text)
- Include foreign key relationships (choose one: Yes, No)
- Output style (choose one: Markdown, HTML)
- Column alignment in tables (choose one: Left, Center, Right)
- Additional notes (longer free text)
- Schema version (free text, e.g. "v1.0")
How it works
- Parse the definitions from whatever form they take into a uniform set of tables, columns, types, keys, and defaults.
- Render each table under a level-two heading with its primary key line and a Name, Type, Nullable, Default, Key, Notes table using the chosen alignment.
- Normalise type spellings to one convention and sort tables alphabetically so versions diff cleanly.
- Add the Relationships section with one child.column references parent.column line per foreign key when requested.
- Prepend the version header and notes and return everything as one fenced block in the chosen style.
What you get
A single fenced block (markdown or html) containing the version header, notes, one uniformly structured section per table in alphabetical order, and a Relationships section when requested.
What it watches out for
- Keeping each table's original column order and type spelling, so the reference inherits the inconsistency it was meant to remove.
- Adding commentary or explanations between tables, which belongs in documentation and breaks copy-paste into a wiki.
- Dropping defaults and nullability because the source omitted them; write unknown rather than guessing.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.