Why does this skill require language tags on every code block?

Language tags like 'bash' or 'json' are required to ensure that documentation viewers, IDEs, and static site generators can provide accurate syntax highlighting and readability.

What is considered 'AI slop' in these guidelines?

AI slop refers to unnecessary informal elements often found in AI-generated text, such as emojis and emdashes, which are removed to maintain a professional technical tone.

How does the skill handle heading hierarchy?

It ensures every file starts with a single H1 title and prevents the common mistake of using bold text for section titles, enforcing semantic ## and ### levels instead.

Should I run any other commands after writing my Markdown file?

Yes, the skill recommends running the /md-lint command to finalize formatting and ensure total compliance with the defined syntax rules.

Markdown Syntax Standards

Name: Markdown Syntax Standards
Author: jimweller

byjimweller

0•

コンテンツ管理

Enforces strict Markdown formatting rules and structural guidelines to ensure clean, professional, and consistent documentation.

The Markdown Syntax Standards skill provides a specialized set of authoring rules designed to maintain high-quality documentation within your project. It enforces critical formatting practices such as mandatory language tags for code blocks, proper heading hierarchies with a single H1 per file, and strict spacing rules between elements. By eliminating informal 'AI slop' like emojis and emdashes, it ensures that your technical documentation remains professional, readable, and compatible with various rendering engines and linting tools. This skill is essential for teams looking to standardize their READMEs, guides, and technical wikis.

主な機能

01Automated vertical spacing and trailing newline management

020 GitHub stars

03Integration with md-lint for comprehensive document validation

04Mandatory language tagging for all code blocks to ensure proper syntax highlighting

05Removal of informal elements like emojis and non-standard emdashes

06Strict heading hierarchy enforcement with single-H1 validation

ユースケース

01Preparing Markdown content for static site generators or professional publishing platforms

02Standardizing documentation across large-scale technical repositories

03Refining AI-generated content to meet enterprise-grade editorial standards

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

主な機能

01Automated vertical spacing and trailing newline management

020 GitHub stars

03Integration with md-lint for comprehensive document validation

04Mandatory language tagging for all code blocks to ensure proper syntax highlighting

05Removal of informal elements like emojis and non-standard emdashes

06Strict heading hierarchy enforcement with single-H1 validation

ユースケース

01Preparing Markdown content for static site generators or professional publishing platforms

02Standardizing documentation across large-scale technical repositories

03Refining AI-generated content to meet enterprise-grade editorial standards