mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00

Merge origin/dev: reconcile docs redesign with upstream skill changes

- Resolve conflicts: keep redesigned skills index, take dev's cs-aeo link
  fix, union of DOMAIN_SEO_CONTEXT entries in generate-docs.py
- Regenerate catalog on the merged tree (dev's agent/command description
  updates, removed ai-seo/release-manager/command-guide, restructured
  universal-scraping-architect)
- Update counters to post-merge truth from scripts/derive_counters.py:
  345 skills, 78 plugins (14 bundles + 64 standalone), 570+ Python tools
- Add redirects for upstream-removed pages (ai-seo -> aeo,
  release-manager -> changelog-generator, command-guide -> engineering index)
- Add compliance-os bundle to bundle tables; rebuild 78-plugin table from
  marketplace.json
- Teach the generator to rewrite repo-root-relative source links to GitHub
  URLs — mkdocs build --strict now passes with zero warnings

https://claude.ai/code/session_015bYZ97nV4oRb3LbxCRFVcP

2026-06-11 15:52:42 +00:00

3.3 KiB

Raw Permalink Blame History

title	description
/cs-markdown-html — Slash Command for AI Coding Agents	Top-level markdown-to-HTML router. Classifies the input markdown (document / review / slides), checks the design-system onboarding gate + 100-line. Slash command for Claude Code, Codex CLI, Gemini CLI.

/cs-markdown-html

:material-console: Slash Command :material-github: Source

Route this conversion through the markdown-html-orchestrator skill:

$ARGUMENTS

Pre-flight gates (refuse and surface, never override)

Input < 100 lines. Markdown still wins below the threshold (Shihipar). Refuse with the line count + recommendation to keep as markdown.
Design-system not onboarded. Surface python3 markdown-html/skills/design-system/scripts/onboard.py and re-prompt after.
Output directory unwritable. Refuse; let the user fix the path or re-onboard.

Routing (deterministic, two-signal threshold)

Signal class	Filename hints	Content signals	Sub-skill
DOCUMENT	`report.md`, `spec.md`, `rfc-.md`, `-doc.md`, `-analysis.md`, `-explainer.md`	`## Table of Contents`, `^#` , `^##` , table rows, GFM callouts	`md-document`
REVIEW	`review.md`, `-pr-.md`, `.diff.md`, `code-review.md`	```diff, `^[-+]{3}` , `^@@`, `> [!BLOCKER]/[!MAJOR]/[!MINOR]/[!NIT]`, `LGTM`/`nit:`/`blocker:`	`md-review`
SLIDES	`deck.md`, `slides.md`, `-talk.md`, `presentation.md`	`^---$` ≥ 3, `<!-- notes:`, H1 cadence ≥ 5 with median gap ≤ 12 lines	`md-slides`

Pipeline:

python3 markdown-html/skills/markdown-html-orchestrator/scripts/doctype_classifier.py \
    --input "$ARGUMENTS" --output json \
  | python3 markdown-html/skills/markdown-html-orchestrator/scripts/route_explainer.py

python3 markdown-html/skills/markdown-html-orchestrator/scripts/output_path_resolver.py \
    --input "$ARGUMENTS" --doctype <verdict>

Silent-route only when winner ≥ 3 AND (runner-up = 0 OR winner ≥ 2× runner-up).
Single signal or tie → one clarifying question with a recommended answer.
No signals → ask which lane, recommend md-document as the safe default.

Output (≤ 100-word digest)

Input lines + doctype
Output path (resolved by output_path_resolver.py)
Design style + brand primary applied (from config_loader.py)
Top 3 features used (sticky TOC, scrollspy, code-copy, severity badges, presenter mode, etc.)
One forcing question for the user (cite Shihipar / WCAG / Lupton / Tufte)

Hard rules

Never silently chain two converters. Pick one, finish, ask before chaining.
Never override a REFUSE from route_explainer.py.
Never invent brand colors when the user hasn't onboarded. Surface onboarding.
Output is single-file HTML. External CDN is limited to Google Fonts + Prism.js.

Status

All five skills are live (orchestrator + design-system + the three converters). This command runs the classifier + design-system gate, then hands the conversion to the routed converter sub-skill (/cs:md-document, /cs:md-review, or /cs:md-slides). Never render HTML inline — the converter scripts own the rendering.

3.3 KiB Raw Permalink Blame History Unescape Escape