What does the md-syntax skill do?

It provides Claude with a specific set of rules for writing markdown, focusing on professional formatting, correct heading usage, and mandatory code block language tags.

Does it work with other markdown tools?

Yes, it is specifically designed to prepare files for the /md-lint command to ensure that the final output passes all automated formatting checks.

How does it handle code blocks?

The skill requires every code block to have a specified language (e.g., bash, yaml, json) and prevents the use of bare backticks which can break syntax highlighting.

Why does this skill forbid emojis and emdashes?

These elements are often considered 'AI slop' in professional technical documentation; the skill removes them to maintain a clean, minimalist, and standardized tone.

Markdown Syntax Standards

Name: Markdown Syntax Standards
Author: jimweller

byjimweller

0•

콘텐츠 관리

Enforces professional markdown formatting and structural standards for high-quality technical documentation.

The Markdown Syntax skill provides a rigorous set of rules for Claude to follow when authoring or editing markdown files, ensuring consistency and readability across your documentation. It mandates explicit language tags for all code blocks, eliminates stylistic 'AI slop' like emojis, and enforces strict structural integrity through proper heading hierarchies and spacing. This skill is ideal for developers and technical writers who need to maintain clean, professional-grade documentation that is compatible with automated linting tools and version control systems.

주요 기능

01Automated trailing newline verification for file consistency

02Removal of unnecessary emojis and emdashes for professional tone

030 GitHub stars

04Strict heading hierarchy enforcement including single H1 at file start

05Standardized spacing rules between paragraphs, lists, and code blocks

06Mandatory language tagging for all code blocks to ensure syntax highlighting

사용 사례

01Preparing markdown files for seamless integration with md-lint tools

02Cleaning up AI-generated content to meet professional publishing standards

03Standardizing technical documentation and README files in 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