Help us improve
Share bugs, ideas, or general feedback.
From md-publisher
This skill should be used when the user asks to "rebuild themes", "refresh themes after upgrading the plugin", "apply new template defaults to existing themes", "regenerate mermaid-config for installed themes", or invokes /md-publisher:rebuild-themes. Walks built-in and user-installed themes and re-derives `mermaid-config.json` + `preview.html` from each theme's `spec.json`, picking up any template improvements that shipped after the theme was originally created.
npx claudepluginhub ehartye/md-publisher --plugin md-publisherHow this skill is triggered — by the user, by Claude, or both
Slash command
/md-publisher:rebuild-themesThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Re-derive `mermaid-config.json` and `preview.html` for every installed theme from the theme's persisted `spec.json`. Use this after a plugin upgrade that improves the scaffold-theme template — it brings already-installed themes in line with the new defaults without asking the author to re-run theme-advisor.
Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Grills users relentlessly on plans or designs by interviewing branch-by-branch through decision trees to reach shared understanding. Use for stress-testing ideas or 'grill me'.
Share bugs, ideas, or general feedback.
Re-derive mermaid-config.json and preview.html for every installed theme from the theme's persisted spec.json. Use this after a plugin upgrade that improves the scaffold-theme template — it brings already-installed themes in line with the new defaults without asking the author to re-run theme-advisor.
Trigger on any of:
spec.json and wanting the derived files updated/md-publisher:rebuild-themesFor each theme directory containing spec.json:
mermaid-config.json — re-derived from the spec's palette + fontspreview.html — re-derived; includes the multi-diagram showcase if the runtime is bootstrappedNOT rewritten:
style.css — out of scope; CSS template changes are a separate concerncover.css — samespec.json — input, not outputInvoke the script with no arguments to list which themes would be migrated:
${CLAUDE_PLUGIN_ROOT}/skills/rebuild-themes/scripts/rebuild-themes.py
The script walks two roots in order: <plugin-root>/themes/*/ (built-in) and ~/.md-publisher/themes/*/ (user-installed). Only directories containing spec.json are eligible.
Show the list and ask: "Apply migration to these N themes? Each will be backed up to <theme-dir>/.backup-<YYYYMMDD-HHMMSS>/ before being rewritten." Wait for explicit confirmation.
${CLAUDE_PLUGIN_ROOT}/skills/rebuild-themes/scripts/rebuild-themes.py --apply
Each theme's pre-migration files are copied to a timestamped backup directory inside the theme. The script prints one line per theme migrated.
Use --theme <slug> to migrate only one theme (still requires --apply). Useful for spot-checking a template change.
${CLAUDE_PLUGIN_ROOT}/skills/rebuild-themes/scripts/rebuild-themes.py --apply --theme atlas-light
Tell the user:
preview.html to verify the visual result before relying on the migrationspec.json — that theme is skipped with a stderr warning naming it. (Themes shipped before spec persistence are the typical case.)scripts/rebuild-themes.py — the migrator${CLAUDE_PLUGIN_ROOT}/skills/theme-advisor/scripts/scaffold-theme.py — source of the templates and substitution helpers (imported via importlib)