How do I install the Md Design System skill?

Run npx skillmds@latest add hashlips/md-design-system in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Md Design System safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Md Design System?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Md Design System free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Md Design System?

HashLips (@hashlips) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Md Design System by hashlips — Agent Skill

Name: Md Design System
Author: HashLips

Md Design System

Lightweight Markdown formatter contract for consistent structure across docs, skills, and agents. Use when you need format normalization (headings, sections, lists, syntax) without changing facts or template-required content.

HashLips Updated Sep 21, 2026

File contents

MD Design System

Use this as a lightweight formatter contract.

Core Rules

Format only — never change facts, decisions, constraints, or values.
Template first — if another skill defines required sections/fields, keep them.
One H1 + no heading skips — # then ## then ### then ####.
Lists over prose — prefer bullets and steps for scanability.
Named items over tables — use - **name** — value for fields/interfaces.
Canonical syntax — - bullets, 1. ordered lists, fenced code, [label](url).
Lean output — remove decorative noise and repetition.
Canonical filenames — enforce kebab-case, -agent.md for agents, and SKILL.md as skill entry file.

Workflow

Choose scope:
- Single-file edit -> follow lightweight flow.
- Package refactor -> use package mode from references/context-budget.md.
Pick document profile from references/canonical-profiles.md.
Keep template-required sections and field placement intact.
Normalize headings, lists, variables/interfaces, and code formatting.
Run references/normalization-checklist.md.

Reference Index

Profiles (section order): references/canonical-profiles.md
Molecules (section shapes): references/molecules.md
Syntax rules: references/canonical-syntax.md
QA and fact-preservation checks: references/normalization-checklist.md
Context policy: references/context-budget.md

When To Use This Skill

Formatting/refactoring Markdown for consistent structure.
Applying style contracts without changing meaning.
Enforcing predictable, lean outputs across skills and agents.

---name: md-design-systemdescription: Lightweight Markdown formatter contract for consistent structure across docs, skills, and agents. Use when you need format normalization (headings, sections, lists, syntax) without changing facts or template-required content.---# MD Design SystemUse this as a lightweight formatter contract.## Core Rules1. **Format only** — never change facts, decisions, constraints, or values.2. **Template first** — if another skill defines required sections/fields, keep them.3. **One H1 + no heading skips** — `#` then `##` then `###` then `####`.4. **Lists over prose** — prefer bullets and steps for scanability.5. **Named items over tables** — use `- **name** — value` for fields/interfaces.6. **Canonical syntax** — `-` bullets, `1.` ordered lists, fenced code, `[label](url)`.7. **Lean output** — remove decorative noise and repetition.8. **Canonical filenames** — enforce kebab-case, `-agent.md` for agents, and `SKILL.md` as skill entry file.## Workflow1. Choose scope: - Single-file edit -> follow lightweight flow. - Package refactor -> use package mode from [references/context-budget.md](references/context-budget.md).2. Pick document profile from [references/canonical-profiles.md](references/canonical-profiles.md).3. Keep template-required sections and field placement intact.4. Normalize headings, lists, variables/interfaces, and code formatting.5. Run [references/normalization-checklist.md](references/normalization-checklist.md).## Reference Index- **Profiles (section order):** [references/canonical-profiles.md](references/canonical-profiles.md)- **Molecules (section shapes):** [references/molecules.md](references/molecules.md)- **Syntax rules:** [references/canonical-syntax.md](references/canonical-syntax.md)- **QA and fact-preservation checks:** [references/normalization-checklist.md](references/normalization-checklist.md)- **Context policy:** [references/context-budget.md](references/context-budget.md)## When To Use This Skill- Formatting/refactoring Markdown for consistent structure.- Applying style contracts without changing meaning.- Enforcing predictable, lean outputs across skills and agents.

Frequently asked questions