From superpowers-plus
Enforces Markdown table best practices including header rows, column limits, and table vs list decisions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/superpowers-plus:markdown-table-disciplineThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **Wrong skill?** AI slop detection → `detecting-ai-slop`. README writing → `readme-authoring`. Plan/roadmap → `plan-quality-gates`.
Wrong skill? AI slop detection →
detecting-ai-slop. README writing →readme-authoring. Plan/roadmap →plan-quality-gates.
Enforces best practices for Markdown table construction. This skill auto-triggers when the AI is writing or editing Markdown documents (README.md, wiki pages, skill.md files, documentation).
BEFORE creating ANY table, evaluate:
| Condition | Action |
|---|---|
| Fewer than 3 rows AND fewer than 3 columns | Use a bullet list instead |
| One column contains multi-sentence paragraphs | Use headings + bullet lists instead |
| Data is hierarchical (Feature → Pros/Cons/Notes with prose) | Use nested bullets instead |
| User needs to scan/compare items on same attributes | Use a table ✓ |
Example — Convert tiny table to list:
❌ Wrong:
| Setting | Value |
|---------|-------|
| Timeout | 30s |
✅ Correct:
- **Timeout:** 30s
Headerless tables are forbidden. Every table must have a semantic header row.
If more attributes needed:
If a column is an obvious identifier (name, ID, domain):
❌ Wrong:
| Domain | Skill | Description |
|--------|-------|-------------|
| engineering | blast-radius | Finds callers |
| engineering | pre-commit | Runs checks |
| engineering | rigor | Quality hub |
✅ Correct:
| Domain | Skill | Description |
|--------|-------|-------------|
| engineering | blast-radius | Finds callers |
| | pre-commit | Runs checks |
| | rigor | Quality hub |
Each cell should be a single short phrase. If more explanation needed:
Line breaks inside cells render inconsistently across tools. Forbidden unless user explicitly requests.
Avoid multiple links, code blocks, AND lists in the same cell. Refactor to prose if needed.
Alignment: Text left (:---) · numeric right (---:) · status/tags center (:---:).
Spacing: | Name | Value | not |Name|Value|.
Vocabulary: Yes/No/Partial · Low/Medium/High · Required/Optional/Deprecated.
| Anti-Pattern | Example | Fix |
|---|---|---|
| Repetitive primary column | engineering repeated 6 times | Show once, blank for rest |
| Redundant type column | 38/39 rows have same value | Remove column, add footnote |
| Paragraph in cell | Multi-sentence explanation | Move to notes section below |
| Too many columns | 8+ columns, horizontal scroll | Split into multiple tables |
| Tiny table | 2 rows, 2 columns | Convert to bullet list |
| Inconsistent vocabulary | "Yes/Yep/Sure/Affirmative" | Standardize to "Yes/No" |
When tables render to HTML:
<th> headers with scope attributes# Check table column count doesn't exceed 5
awk -F'|' '/^\|/ && NF>7 {print FILENAME":"NR": "NF-1" columns"}' doc.md
See references/examples.md for good/bad table formatting examples.
npx claudepluginhub bordenet/superpowers-plus --plugin superpowers-plusGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.