mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-09-09 22:31:29 +00:00

feat(docs): redesign documentation site — clay design system, accurate counters, markdown-html domain pages

- Rewrite docs/stylesheets/extra.css with a warm clay/coral design system:
  aurora hero with eyebrow badge and stats strip, gradient card hairlines,
  pill tool badges, numbered steps component, reduced-motion support
- Rewrite homepage copy: plain-language 'What is an Agent Skill?' section,
  3-step how-it-works, all 17 domain cards, guides section, accurate stats
  (337 skills / 17 domains / 66 plugins)
- Add missing markdown-html domain to generate-docs.py (17th domain) and
  regenerate catalog: +12 new pages (md-document/md-review/md-slides skills,
  cs-markdown-html-orchestrator + cs-scraping-architect agents, 7 commands)
- Fix skill-internal link rewriting in the generator (./SIBLING.md and
  ALL-CAPS companion files now resolve to GitHub URLs) — mkdocs --strict
  now passes with zero warnings
- Refresh stale counters site-wide (177/192/204/311/338 → 337) in skills
  index, plugins index, getting-started, integrations, custom-gpts, guides
- Rebuild plugins page from live marketplace.json: 13 domain bundles + 53
  standalone plugins, accurate bundle table and full 66-plugin listing
- Add Guides section to nav (5 existing SEO guide pages, URLs unchanged),
  point homepage tool badges at tool-specific guides and real anchors
- Tighten site_description and JSON-LD keywords for 'agent skills' /
  'agent plugins' queries; update announce bar to the markdown-html launch
- No existing slugs or URLs changed — all edits are additive or in-place

https://claude.ai/code/session_015bYZ97nV4oRb3LbxCRFVcP

2026-06-11 15:45:00 +00:00

2.8 KiB

Raw Permalink Blame History

title	description
/cs-design-system — Slash Command for AI Coding Agents	Run the one-time markdown-html design-system onboarding wizard. Captures brand primary/accent (HEX) + heading/body Google Fonts + design style. Slash command for Claude Code, Codex CLI, Gemini CLI.

/cs-design-system

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

Run the design-system wizard:

python3 markdown-html/skills/design-system/scripts/onboard.py $ARGUMENTS

Modes

Flag	Behavior
(no flag)	Interactive — walks 10 questions one at a time. Default.
`--defaults`	Zero-touch: writes built-in defaults (`#0A1628` navy + `#00D4AA` teal + Inter + technical + sticky TOC + `./markdown-html-out/`) without prompting. Useful for CI or first-test.
`--set key=value`	Non-interactive override (repeatable). Dotted keys supported: `brand.primary=#FF6B35`, `typography.heading_font=Lora`, `design_style=editorial`.
`--show`	Print the 10 questions + the current effective config (project > global > defaults).
`--reset`	Delete the saved config at the chosen scope.
`--scope project`	Save to `./.markdown-html/design-system.json` (per-repo override) instead of global `~/.config/markdown-html/design-system.json`.

The 10 questions

Default output directory (path; must be writable)
Brand primary HEX
Brand accent HEX (optional; auto-derives if blank)
Heading Google Font (12 safe defaults)
Body Google Font
Design style: editorial / technical / minimal / playful
Syntax-highlighting theme: light / dark / auto
TOC behavior: sticky-sidebar / collapsible-top / inline / none
Company / project name (optional, shows in footer)
Logo URL (optional, base64-embedded at render time)

Hard refusals

default_output_dir empty or unwritable → exit 3. Pick a path you control.
WCAG AA body-text contrast fails (< 4.5:1) → exit 4. Pick a darker primary, blank brand.bg/brand.text to let derivation pick a passing pair, or override brand.text explicitly.
WCAG link contrast walked iteratively; falls back to a passing color if accent on bg can't reach 4.5:1.

After onboarding

Inspect the effective config:

python3 markdown-html/skills/design-system/scripts/config_loader.py --show
python3 markdown-html/skills/design-system/scripts/config_loader.py --status

Then convert markdown via /cs:markdown-html <path>.md.

Bypass

MARKDOWN_HTML_NO_CONFIG=1 skips saved config and returns DEFAULTS only. Useful for headless CI, ephemeral test containers, and evaluator loops. Never set it silently for an interactive user.

2.8 KiB Raw Permalink Blame History