feat(M2): Documentation flow, accuracy, consistency cleanup, and cross-platform shell portability

skills/.markdownlint.jsonc

@@ -0,0 +1,20 @@
+// markdownlint configuration — skills/ (M2)
+//
+// Agent-facing SKILL.md files and plan templates contain verbose prose and
+// long shell commands where a strict line-length limit is counterproductive.
+// This file inherits the root config and then overrides the two rules that
+// produce false positives in agent-facing content.
+{
+  // Inherit root-level rules
+  "extends": "../.markdownlint.jsonc",
+
+  // MD013 — line length: disabled for skill files.
+  // Shell commands, long option lists, and URL references commonly exceed 120
+  // chars and wrapping them would break copy-paste usability.
+  "MD013": false,
+
+  // MD024 — duplicate headings: disabled for skill files.
+  // SKILL.md files intentionally use repeated per-agent section headings
+  // (e.g. "### Claude Code", "### Codex") in separate variant sections.
+  "MD024": false
+}