hashlips/md-design-system
skills/md-design-system/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add hashlips/agent-skills md-design-systemInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 7:58 AM115.9s6 files scanned
SKILL.md
- name:
- md-design-system
- description:
- 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 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** — valuefor 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.mdfor agents, andSKILL.mdas 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.
Related Skills
hashlips/project-graph
development
VerifiedTrustedCommunity
Generates an interactive HTML map of any coding project showing all files, their connections, and entry-point flows, enriched by a living AI knowledge file that grows as the project is explored. Use when asked to generate a project graph, visualize project structure, map file connections or flows, get a high-level overview of a codebase, or answer questions about a project that already has a generated graph (technologies, services, how a flow works).
16SKILL.mdUpdated Jun 12, 2026
hashlips/skill-scan
development
VerifiedTrustedCommunity
Static security audit of an Agent Skill package (untrusted text only)—safe to run, data-exfil and hidden-action risks, est_tokens, and a verdict. Use only when the user explicitly asks to scan, security-scan, or sanity-check a skill.
12SKILL.mdUpdated May 26, 2026
hashlips/token-estimator
development
VerifiedTrustedCommunity
Gives a consistent rough token-size estimate for a file or folder of text using fixed integer rules. Use when you need repeatable ballpark token counts for Markdown or plain text without calling a provider API.
12SKILL.mdUpdated May 24, 2026
hashlips/md-compressor
testing
VerifiedTrustedCommunity
Compresses Markdown to minimal token form while preserving facts and agent-executable intent; duplicates sources first and compresses skill packages (SKILL.md plus reference MD). Use when reducing context cost in docs, skills, or prompts at light, medium, heavy, or extreme compression.
12SKILL.mdUpdated Apr 22, 2026