Merge pull request #794 from alirezarezvani/dev

Author: alirezarezvani

.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "Alireza Rezvani",
     "url": "https://alirezarezvani.com"
   },
-  "description": "338 production-ready skill packages for Claude AI across 16 domains: engineering advanced (78, incl. v2.9.0 workflow-builder for Claude Code Workflow-tool authoring), engineering core (51), marketing (46 — incl. AEO/Answer Engine Optimization), c-level advisory (66), product (17), regulatory/QMS (18), compliance-os (9), project management (9), business growth (5), finance (4), productivity (6), marketing top-level (1), research (8), research-ops (5, v2.9.0), business-operations (7), and commercial (8). Includes 533 Python tools, 676 reference documents, 51+ agents, 87+ slash commands across 63 marketplace plugins.",
+  "description": "341 production-ready skill packages for Claude AI across 17 domains: engineering advanced (78, incl. v2.9.0 workflow-builder for Claude Code Workflow-tool authoring), engineering core (51), marketing (46 — incl. AEO/Answer Engine Optimization), c-level advisory (66), product (17), regulatory/QMS (18), compliance-os (9), project management (9), business growth (5), finance (4), productivity (6), marketing top-level (1), research (8), research-ops (5, v2.9.0), business-operations (7), commercial (8), and markdown-html (3, v2.10.1 — markdown-to-interactive-HTML converter). Includes 542 Python tools, 685 reference documents, 51+ agents, 88+ slash commands across 64 marketplace plugins.",
   "homepage": "https://github.com/alirezarezvani/claude-skills",
   "repository": "https://github.com/alirezarezvani/claude-skills",
   "metadata": {
-    "description": "338 production-ready skills across 16 domains (engineering, engineering-core, marketing, product, c-level, compliance-os, project management, RA/QM, business growth, finance, productivity, marketing (top-level), research, research-ops, business-operations, commercial, plus standards). 533 Python tools, 676 reference guides, 51+ agents (cs-* + personas), 87+ slash commands across 63 marketplace plugins. v2.9.0 adds the research-ops domain — enterprise Research Operations (clinical-research + research-finance + market-research + product-research + orchestrator) with per-skill onboarding, customization config, and an opt-in autoresearch bridge, plus the engineering workflow-builder skill (intake-first authoring of deterministic multi-agent .js workflows for Claude Code's Workflow tool). Compatible with Claude Code, Codex CLI, Gemini CLI, Cursor, OpenClaw, Hermes Agent, Mistral Vibe, and 5 more coding agents.",
-    "version": "2.9.0"
+    "description": "341 production-ready skills across 17 domains (engineering, engineering-core, marketing, product, c-level, compliance-os, project management, RA/QM, business growth, finance, productivity, marketing top-level, research, research-ops, business-operations, commercial, markdown-html, plus standards). 542 Python tools, 685 reference guides, 51+ agents (cs-* + personas), 88+ slash commands across 64 marketplace plugins. v2.10.1 adds md-document to the markdown-html domain — the long-form markdown-to-single-file-HTML converter (sticky TOC + scrollspy + search filter + code-copy buttons + GFM tables/callouts + Prism.js autoloader; reads the design-system's WCAG-AA-validated 12-token palette so brand changes flow through to every conversion). v2.10.0 shipped the markdown-html foundation (orchestrator + design-system). v2.9.0 shipped the research-ops domain (clinical-research + research-finance + market-research + product-research + orchestrator) with per-skill onboarding, customization config, and an opt-in autoresearch bridge, plus the engineering workflow-builder skill. Compatible with Claude Code, Codex CLI, Gemini CLI, Cursor, OpenClaw, Hermes Agent, Mistral Vibe, and 5 more coding agents.",
+    "version": "2.10.1"
   },
   "plugins": [
     {
@@ -1404,8 +1404,8 @@
     {
       "name": "markdown-html-skills",
       "source": "./markdown-html",
-      "description": "Convert long markdown files in a Claude project into world-class, single-file, lightly-interactive HTML. v2.10.0 foundation ships 2 skills: markdown-html-orchestrator (context: fork; deterministic doctype classifier that routes to converter sub-skills based on filename + content signals; refuses input < 100 lines per Shihipar's threshold; refuses without onboarding) + design-system (10-question onboarding wizard capturing brand primary/accent HEX + heading/body Google Fonts + design style editorial/technical/minimal/playful + default output directory + syntax theme + TOC behavior + optional logo/company; WCAG-AA-validated 12 CSS custom properties derived in HSL space; project > global > defaults precedence with MARKDOWN_HTML_NO_CONFIG=1 bypass). 6 stdlib-only Python tools (3 per skill), 6 references citing 5-7 sources each, 1 JSON schema asset. Inspired by Thariq Shihipar's Claude Code HTML output essay (Medium, 2026). Outputs are single self-contained .html files; only externals are Google Fonts CSS and Prism.js CDN. Converter sub-skills (md-document, md-review, md-slides) land in v2.10.1 follow-up PRs. Distinct from Anthropic's official Playground plugin (interactive prompt-tuning controls with sliders/knobs/prompt-copy-back) and marketing/landing/ (landing-page generator).",
-      "version": "2.10.0",
+      "description": "Convert long markdown files into world-class single-file interactive HTML. v2.10.1 ships md-document — the long-form converter (sticky TOC + scrollspy + search filter + code-copy buttons + GFM tables/callouts + fenced code with Prism.js autoloader + 12 brand CSS custom properties) on top of the v2.10.0 foundation: markdown-html-orchestrator (context: fork; deterministic doc-type classifier; refuses < 100 lines per Shihipar; refuses without onboarding) + design-system (10-question onboarding wizard; WCAG-AA-validated 12-token palette; project > global > defaults precedence; MARKDOWN_HTML_NO_CONFIG=1 bypass). 9 stdlib-only Python tools, 9 references citing 5-7 sources each, 2 template/schema assets. Inspired by Thariq Shihipar's Claude Code HTML output essay (Medium, 2026). Outputs are single self-contained .html files; only externals are Google Fonts CSS and Prism.js CDN. Converter sub-skills md-review + md-slides land in v2.10.2 follow-up PRs.",
+      "version": "2.10.1",
       "author": {
         "name": "Alireza Rezvani"
       },

.codex/skills-index.json

@@ -3,7 +3,7 @@
   "name": "claude-code-skills",
   "description": "Production-ready skill packages for AI agents - Marketing, Engineering, Product, C-Level, PM, and RA/QM",
   "repository": "https://github.com/alirezarezvani/claude-skills",
-  "total_skills": 341,
+  "total_skills": 342,
   "skills": [
     {
       "name": "business-growth-skills",
@@ -587,6 +587,12 @@
       "category": "documentation",
       "description": "Use when a user wants to convert any markdown file in their Claude project into a single-file, lightly-interactive HTML \u2014 long-form documents (specs, plans, RFCs, reports, explainers), code reviews with diffs and severity-tagged annotations, or slide decks. Triggers on \"convert this markdown to HTML\", \"make this an HTML file\", \"turn this into an interactive document\", \"render this report as HTML\", \"PR writeup as HTML\", \"slides from this markdown\". Forks context to route to one of three converter sub-skills (md-document, md-review, md-slides) based on a deterministic doctype classifier, after the user has run the design-system onboarding once. Refuses if input is under 100 lines (per Shihipar \u2014 markdown still wins below the threshold) or design-system isn't onboarded. Distinct from Anthropic's official Playground plugin (which is interactive prompt-tuning controls with sliders/knobs/prompt-copy-back) and from marketing/landing/ (which is a landing-page generator)."
     },
+    {
+      "name": "md-document",
+      "source": "../../markdown-html/skills/md-document",
+      "category": "documentation",
+      "description": "Converts long-form markdown (specs, RFCs, reports, plans, explainers) into a single-file, lightly-interactive HTML document with sticky TOC, scrollspy, search filter, code-copy buttons, and design-system-driven brand tokens. Triggers when the markdown-html-orchestrator classifies an input as DOCUMENT, or when invoked directly via /cs:md-document. Reads the design-system config via config_loader.py and inlines the user's 12 derived CSS custom properties; refuses to render if onboarding hasn't run. Single-file output \u2014 Google Fonts + Prism.js CDN are the only externals; no framework runtime, no build step. Use after orchestrator routing or after design-system onboarding is confirmed."
+    },
     {
       "name": "a11y-audit",
       "source": "../../engineering-team/a11y-audit/skills/a11y-audit",
@@ -2079,7 +2085,7 @@
       "description": "Compliance-OS skills: ISO 13485 / ISO 27001 / SOC 2 / GDPR / FDA QSR / EU AI Act audit-prep + compliance-readiness orchestrator"
     },
     "documentation": {
-      "count": 2,
+      "count": 3,
       "source": "../../markdown-html",
       "description": "Markdown-to-HTML converter (v2.10.0 foundation): orchestrator (context: fork, deterministic doctype classifier, refuses < 100 lines per Shihipar) + design-system (one-time onboarding wizard with WCAG-AA-validated 12-token palette, project > global > defaults precedence). Converter sub-skills (md-document, md-review, md-slides) land in v2.10.1."
     },

.codex/skills/md-document

@@ -0,0 +1 @@
+../../markdown-html/skills/md-document

CLAUDE.md

@@ -145,6 +145,26 @@ See [standards/git/git-workflow-standards.md](standards/git/git-workflow-standar
 
 ## Current Version
 
+**Version:** v2.10.1 (md-document — long-form converter for the markdown-html/ domain)
+
+**v2.10.1 highlights — md-document (long-form markdown → single-file HTML):**
+
+Adds the third skill to `markdown-html/` (foundation shipped in v2.10.0). The 90%-case converter: any markdown spec, plan, RFC, report, or explainer becomes a single-file, lightly-interactive HTML document with the user's onboarded brand.
+
+- **`md-document` skill** — three stdlib tools pipeline together (markdown_parser.py → html_renderer.py → interactivity_injector.py):
+  - **`markdown_parser.py`** — CommonMark subset → section AST (headings 1-6 with slug anchors, paragraphs with inline bold/italic/code/links/images, fenced code with language tag, GFM tables with per-column alignment, GFM callouts NOTE/TIP/IMPORTANT/WARNING/CAUTION, blockquotes, ordered + unordered lists, horizontal rules). Stdlib regex + state machine, no `markdown` dependency.
+  - **`html_renderer.py`** — section AST + design-system config → single-file HTML. Inlines the 12 derived CSS custom properties from `~/.config/markdown-html/design-system.json`, applies the user's `design_style` (editorial/technical/minimal/playful) via body-class CSS overrides, renders Google Fonts CDN link + Prism.js theme link per `code_theme`, emits sticky-sidebar / collapsible-top / inline / none TOC per `toc.behavior`. Smoke-tested: changing design_style actually changes max-width, line-height, callout shape, and code font-size — customization is in-use, not decorative.
+  - **`interactivity_injector.py`** — vanilla-JS payload injected before `</body>`: search filter on H2 sections (Esc clears), code-copy buttons (navigator.clipboard with execCommand fallback), smooth-scroll on TOC links, scrollspy via IntersectionObserver (sets `aria-current="location"` on the matching TOC entry). Idempotent (marker check). Feature subset selectable via `--features search,copycode,smoothscroll,scrollspy`.
+- **3 reference docs**, each citing 5-7 sources: `information_density_patterns.md` (Shihipar + Tufte + Wattenberger + Appleton + Ciechanowski + Bret Victor + Jakob Nielsen), `toc_and_nav_ux.md` (NN/g + WCAG 2.2 + ARIA APG + Vitepress/Docusaurus/mdBook convergence + GOV.UK design system + MDN IntersectionObserver), `single_file_html_discipline.md` (Shihipar + Tom MacWright's Big + Google Fonts API + Prism.js + Anil Dash's *The Web We Lost*).
+- **1 template asset** (`md_document_template.html`) documenting the canonical output shape for renderer reference.
+- **`/cs:md-document` slash command** ships the pre-flight gates + 3-tool pipeline + output digest.
+- **Empirical footprint**: ~150-line markdown → 11 KB HTML / 15 KB with JS; ~470-line markdown → 17 KB / 23 KB with JS. By comparison, equivalent Notion/Confluence/GitBook exports are 200 KB+ of CSS chrome.
+- **Plugin manifest:** `markdown-html-skills` plugin.json `skills` array now lists 3 paths (orchestrator + design-system + md-document). Marketplace + root CLAUDE.md counters updated: 64 plugins, 17 domains, **341 skills** (was 338 before v2.10.0). Cleans up stale 338/63 counters left by v2.10.0 PR #780.
+
+**Coming in v2.10.2:** `md-review` (2-col diff + severity-tagged margin annotations + jump-nav) and `md-slides` (arrow-key nav + presenter mode + print-to-PDF). Both will reuse `md-document`'s renderer scaffolding and `design-system/scripts/config_loader.py`.
+
+---
+
 **Version:** v2.10.0 (foundation released — `markdown-html/` domain: markdown-to-interactive-HTML converter)
 
 **v2.10.0 foundation highlights — markdown-html/ domain (new top-level domain):**

markdown-html/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "markdown-html-skills",
-  "description": "Convert long markdown files in a Claude project into world-class, single-file, lightly-interactive HTML. Foundation (v2.10.0): 2 skills — markdown-html-orchestrator (context: fork; deterministic doc-type classifier routing to converter sub-skills; refuses to silently chain) + design-system (one-time onboarding wizard that captures brand primary/accent + heading/body Google Fonts + design style + default output dir + syntax theme + TOC behavior + optional logo/company; WCAG-validated palette derivation in HSL space producing 12 CSS custom properties consumed by every converter; project>global>defaults precedence; MARKDOWN_HTML_NO_CONFIG=1 bypass). 6 stdlib-only Python tools (3 per skill), 6 references citing 5-7 sources each, 1 JSON schema asset. Inspired by Thariq Shihipar's argument (Claude Code HTML output, Medium 2026) that markdown collapses past 100 lines and HTML restores information density + visual clarity + shareability + lightweight interaction. Outputs are single self-contained .html files; only externals are Google Fonts and Prism.js CDN. Converter sub-skills (md-document, md-review, md-slides) land in v2.10.1 follow-up PRs. Distinct from Anthropic's official Playground plugin (which is interactive prompt-tuning controls with sliders/knobs/prompt-copy-back) and from marketing/landing/ (which is a landing-page generator).",
-  "version": "2.10.0",
+  "description": "Convert long markdown files in a Claude project into world-class, single-file, lightly-interactive HTML. v2.10.1 ships md-document — the long-form converter (sticky TOC + scrollspy + search filter + code-copy buttons + GFM tables/callouts + fenced code with Prism.js autoloader + 12 brand CSS custom properties from the design-system) on top of the v2.10.0 foundation: markdown-html-orchestrator (context: fork; deterministic doc-type classifier; refuses < 100 lines per Shihipar; refuses without onboarding) + design-system (10-question onboarding wizard; WCAG-AA-validated 12-token palette; project > global > defaults precedence; MARKDOWN_HTML_NO_CONFIG=1 bypass). 9 stdlib-only Python tools (3 per skill), 9 references citing 5-7 sources each, 2 template/schema assets. Inspired by Thariq Shihipar's Claude Code HTML output essay (Medium, 2026). Outputs are single self-contained .html files; only externals are Google Fonts CSS and Prism.js CDN. Converter sub-skills md-review + md-slides land in v2.10.2 follow-up PRs. Distinct from Anthropic's official Playground plugin (interactive prompt-tuning controls with sliders/knobs/prompt-copy-back) and marketing/landing/ (landing-page generator from scratch).",
+  "version": "2.10.1",
   "author": {
     "name": "Alireza Rezvani",
     "url": "https://alirezarezvani.com"
@@ -11,11 +11,12 @@
   "license": "MIT",
   "skills": [
     "./skills/markdown-html-orchestrator",
-    "./skills/design-system"
+    "./skills/design-system",
+    "./skills/md-document"
   ],
   "source": {
     "spec": "Thariq Shihipar — Claude Code HTML output essay (Medium, 2026). Argument: markdown collapses past 100 lines for agent-generated artifacts; HTML restores information density, visual clarity, shareability, and lightweight interaction.",
-    "build_pattern": "Path B (direct conversion). Orchestrator uses context: fork (research-ops shape). Shared design-system owns onboarding + 12 CSS custom properties read by all converters. Every SKILL.md ships a Forcing-question library section per Matt Pocock grill-with-docs discipline. Foundation PR ships orchestrator + design-system; converter sub-skills (md-document, md-review, md-slides) land in v2.10.1 follow-up PRs.",
+    "build_pattern": "Path B (direct conversion). Orchestrator uses context: fork (research-ops shape). Shared design-system owns onboarding + 12 CSS custom properties read by all converters. Every SKILL.md ships a Forcing-question library section per Matt Pocock grill-with-docs discipline. v2.10.0 shipped the foundation (orchestrator + design-system); v2.10.1 adds md-document (the long-form converter); md-review + md-slides land in v2.10.2.",
     "distinct_from": "Anthropic's official Playground plugin builds interactive prompt-tuning controls (sliders, knobs, prompt-copy-back); this plugin converts existing markdown documents to single-file HTML. Also distinct from marketing/landing/ which generates landing pages from scratch."
   }
 }