Does this skill require specific code block tagging?

Yes, it mandates that every code block includes a specific language identifier, such as 'bash', 'yaml', or 'json', and prohibits the use of bare backticks.

What is 'AI slop' in the context of this skill?

AI slop refers to unnecessary emojis and em-dashes that can clutter professional documentation or interfere with specific parsing tools. This skill strips them to maintain a clean aesthetic.

How does the skill handle section titles?

It ensures that section titles use proper heading levels (##, ###) rather than bolded text on a single line, which improves document structure and navigation.

Can I use multiple H1 tags in a single file?

No, the skill enforces a 'One H1 per file' rule, requiring the first line of every markdown document to be the single H1 title.

How do I verify my markdown is correct after editing?

The skill provides a guideline to run the /md-lint command after writing to automatically format and lint the file for final production readiness.

Markdown Authoring Standards

Name: Markdown Authoring Standards
Author: jimweller

byjimweller

0•

コンテンツ管理

Enforces strict markdown syntax and formatting rules to ensure high-quality, professional documentation.

The md-syntax skill provides Claude with a comprehensive set of rules for creating and editing markdown files, ensuring consistency across all documentation. It mandates proper language tagging for code blocks, enforces heading hierarchies over bold text for sections, and eliminates stylistic 'AI slop' like emojis and em-dashes. By integrating with the md-lint workflow, it ensures every file is correctly formatted with proper spacing and single H1 titles, making it an essential tool for developers and technical writers maintaining clean, readable, and professional repositories.

主な機能

010 GitHub stars

02Mandatory language tagging for all code blocks

03Automated md-lint integration for final formatting

04Removal of 'AI slop' (emojis and em-dashes)

05Consistent spacing and trailing newline management

06Strict heading hierarchy enforcement (H1 usage rules)

ユースケース

01Preparing markdown content for automated documentation generators

02Writing clean technical guides without stylistic clutter or formatting errors

03Standardizing README files and documentation across large repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimweller/davit-dataops-dotfiles md-syntax

For use in Claude.ai and ChatGPT

Download Skill