New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Markdown Link Validator

Md validation

by haowjy · Apache-2.0 license · ★ 506 on GitHub

Md validation cover

Use when validating markdown links or Mermaid diagrams.

---
name: md-validation
description: Use when validating markdown links or Mermaid diagrams.
---

# md-validation

## Mermaid Diagrams

Validate Mermaid diagrams render correctly before shipping. Open the HTML
artifact in a browser and check every diagram visually — syntax errors show
as broken renders, not error messages.

Common failure modes:
- Unquoted labels with punctuation break the parse
- Bare lowercase `end` collides with subgraph terminator
- Node IDs starting with `o` or `x` after edge markers get misparsed
- Custom fills without matching text color make labels unreadable

Overview

Validate Mermaid diagrams render correctly before shipping. Open the HTML artifact in a browser and check every diagram visually — syntax errors show as broken renders, not error messages.

Manual install (npx, ZIP)
Claude Codenpx skills add haowjy/creative-writing-skills --skill md-validation -g -a claude-code
Claude Code (degit)npx degit haowjy/creative-writing-skills/cw/skills/md-validation#main ~/.claude/skills/md-validation
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md911 B
Read SKILL.md here
haowjy/main1 file shown
SKILL.md
Show the full text28 lines
md-validation/SKILL.md28 lines · 0.9 KB

md-validation

Mermaid Diagrams

Validate Mermaid diagrams render correctly before shipping. Open the HTML artifact in a browser and check every diagram visually — syntax errors show as broken renders, not error messages.

Common failure modes:

  • Unquoted labels with punctuation break the parse
  • Bare lowercase end collides with subgraph terminator
  • Node IDs starting with o or x after edge markers get misparsed
  • Custom fills without matching text color make labels unreadable

See resources/mermaid-authoring.md for the full authoring rules (quoting, line breaks, reserved words, themes).

Check that relative links between pages resolve. When building a multi-page artifact or KB, broken cross-references silently rot — verify each link target exists before committing.

1---
2name: md-validation
3description: Use when validating markdown links or Mermaid diagrams.
4---
5 
6# md-validation
7 
8## Mermaid Diagrams
9 
10Validate Mermaid diagrams render correctly before shipping. Open the HTML
11artifact in a browser and check every diagram visually — syntax errors show
12as broken renders, not error messages.
13 
14Common failure modes:
15- Unquoted labels with punctuation break the parse
16- Bare lowercase `end` collides with subgraph terminator
17- Node IDs starting with `o` or `x` after edge markers get misparsed
18- Custom fills without matching text color make labels unreadable
19 
20See `resources/mermaid-authoring.md` for the full authoring rules (quoting,
21line breaks, reserved words, themes).
22 
23## Markdown Links
24 
25Check that relative links between pages resolve. When building a multi-page
26artifact or KB, broken cross-references silently rot — verify each link
27target exists before committing.
28 
View all files on GitHub →

Details

License
Apache-2.0
Stars on the repo
★ 506
Checked
Source
haowjy/creative-writing-skills ↗
Creator
haowjy · 22 listings
View creator

Similar skills

See all →

More from haowjy

Character Voice Simulatorhaowjy/creative-writing-skills · by haowjySpeak as a specified character from their current knowledge, voice, and emotional state. Use for skill-only workflows that need in-character conversation, voice discovery, or relationship pressure tests.★ 506 GitHub starsStory Research Assistanthaowjy/creative-writing-skills · by haowjyLoad when a story needs factual grounding the writer doesn't have: historical detail, cultural texture, domain accuracy, or how other authors handled similar material. Pass the question and story context; returns a sourced report the writer can draw from.★ 506 GitHub starsFiction Writing Craft Guidehaowjy/creative-writing-skills · by haowjyCraft references for writing fiction well: prose, scenes, style, voice, and genre/page-level technique. Load when a writer, critic, or muse needs how-to-write guidance rather than a production mode.★ 506 GitHub starsWriting Mode Guidehaowjy/creative-writing-skills · by haowjyCreative-writing addendum to /llm-writing. Load when putting prose on the page: draft, revise, bridge, vary, or polish.★ 506 GitHub starsMulti-Mode Writing Studiohaowjy/creative-writing-skills · by haowjyLoad when no subagents are available and one agent must plan, draft, critique, research, and capture memory by switching stances.★ 506 GitHub starsOutput Information Hierarchyhaowjy/creative-writing-skills · by haowjyLoad for large human-facing outputs: reports, docs, multi-section explanations, artifacts. Choose the right form for each beat (prose, diagram, table, mockup) and put the answer first, depth behind it. If the medium allows, use progressive disclosure.★ 506 GitHub stars