Theme Review

Overview

Review an existing or proposed Stencila theme artifact for correctness, token usage, target coverage, portability, maintainability, and approval readiness.

The artifact may be a workspace theme.css, a patch or diff, a CSS snippet, or a sufficiently concrete theme plan before implementation. The primary mode of this skill is assess and report: identify concrete issues, missing verification, risky assumptions, approval blockers, and target-specific gaps.

This is a review-only skill. Do not use it to create a new skill, write SKILL.md, design a theme from scratch, or generate a full new theme by default. Use it when the user wants an assessment of an existing artifact or a concrete proposed direction.

Use the local references in this skill directory when you need architecture or token-family guidance:

• references/themes-guide.md for theme architecture, resolution rules, and cross-target constraints
• references/semantic-and-font-tokens.md for semantic-token and font review guidance
• references/node-token-families.md for document/node token families
• references/print-and-pdf-tokens.md for print and PDF page tokens
• references/plot-tokens.md for plot theming review
• references/site-token-families.md for site-theme component families and naming quirks
• references/cli-commands.md for token discovery and validation commands
• references/snap-tool.md for visual verification with the snap tool and the /_specimen route

Also use the theme CLI as the live source of truth when available: