π Markdown Table Formatter
Align messy Markdown tables so the raw source is actually readable, or build a clean GitHub-Flavored table from pasted CSV. Pads every column to its widest cell, normalizes the header separator row, and preserves your alignment markers (:--, :--:, --:). Changes spacing only, never the cell content. Prints to the screen by default and rewrites the file in place only when you ask.
- Normalize column widths in large Markdown files for better readability.
- Convert CSV or TSV exports into GitHub-Flavored Markdown tables.
- Fix broken table structures and pipe alignment automatically.
Free
Included in download
- Downloadable skill package
- Works with Cursor, Codex CLI
- 3 permissions declared
Sample input
Align the messy markdown table in README.md and convert the data in data.csv into a table at the end of the file.
Sample output
| Feature | Status | | :--- | :--- | | Auth | Done | | API | Pending |
Table from data.csv: | ID | Name | Value | | :-- | :-- | :-- | | 101 | Server A | 99.9% | | 102 | Server B | 95.0% |
Align messy Markdown tables so the raw source is actually readable, or build a clean GitHub-Flavored table from pasted CSV. Pads every column to its widest cell, normalizes the header separator row, and preserves your alignment markers (:--, :--:, --:). Changes spacing only, never the cell content. Prints to the screen by default and rewrites the file in place only when you ask.
Free
Included in download
- Downloadable skill package
- Works with Cursor, Codex CLI
- 3 permissions declared
- Instant install
Sample input
Align the messy markdown table in README.md and convert the data in data.csv into a table at the end of the file.
Sample output
| Feature | Status | | :--- | :--- | | Auth | Done | | API | Pending |
Table from data.csv: | ID | Name | Value | | :-- | :-- | :-- | | 101 | Server A | 99.9% | | 102 | Server B | 95.0% |
About This Skill
What it does
The Markdown Table Formatter is a specialized utility designed to clean up messy, poorly aligned GitHub-Flavored Markdown (GFM) tables. It normalizes column widths and handles spacing to ensure your documentation remains readable in raw text format. Beyond simple formatting, it provides bridge functionality to convert CSV and TSV data directly into valid Markdown tables.
Why use this skill
Manual table formatting in Markdown is tedious and error-prone. While many AI agents can "fix" a table, they often hallucinate cell content or alter data unintentionally. This skill uses a deterministic formatting engine that guarantees cell content remains untouched while strictly enforcing structural alignment. It is ideal for developers maintaining large documentation repositories where visual consistency is required.
Supported features
- Visual Alignment: Automatically adjusts padding so columns line up perfectly.
- CSV/TSV Conversion: Quickly transform spreadsheet exports into Markdown.
- Safety First: Built-in guardrails prevent overwriting files without explicit flags.
- GFM Compliance: Outputs tables compatible with GitHub, GitLab, and most modern Markdown parsers.
Use Cases
- Normalize column widths in large Markdown files for better readability.
- Convert CSV or TSV exports into GitHub-Flavored Markdown tables.
- Fix broken table structures and pipe alignment automatically.
- Batch process documentation files to ensure consistent table styling.
Known Limitations
It is a formatter for GitHub-Flavored pipe tables. It does not touch HTML tables or other non-pipe formats, and it changes whitespace, not content. Wildly malformed tables may need a manual pass first.
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/markdown-table-formatter -o /tmp/markdown-table-formatter.zip && unzip -o /tmp/markdown-table-formatter.zip -d ~/.claude/skills && rm /tmp/markdown-table-formatter.zipFree skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
File Scopes
Prints formatted output to stdout by default. A --from-csv mode turns pasted CSV or TSV into a table. It only adjusts spacing and alignment; it does not change what the cells say. Reads no environment variables.
Works with any agent that can read a file and run a local Python script (Claude Code, Cursor, Codex CLI, and other SKILL.md-compatible agents). Standard library only, no install step.
Creator
JustHandled Labs creates focused agent skills and workflow packs for Claude, Codex, Cursor, and AI-assisted builders. Each tool is designed around a real repeatable task: cleaner commits, better PRs, stronger handoffs, safer repo hygiene, clearer documentation, and less copy-paste chaos. The goal is not generic AI productivity. The goal is specific workflows that are easier to run, review, and repeat. Maintained by H.J. Westerfield, with a background in communications, editing, project coordination, customer support, and practical AI systems. JustHandled Labs builds tools for people who want useful automation without theatrical complexity.
Frequently Asked Questions
Learn More About AI Agent Skills
More Premium Skills
inline-comment
Best way to steer your agents, effortlessly.
designing-hybrid-context-layers
Architects the right retrieval strategy for every query β teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.
consumer-motivation-analyzer
Go beyond surface-level feedback to uncover the psychological drivers and hidden motivations behind buyer behavior.
keyword-research
Transform URLs or product lists into SEO keyword research packs with Google Ads data and intent-based clustering.