# Theme Review

Critically review an existing or proposed Stencila theme artifact for correctness...

- Repository: https://github.com/stencila/stencila (914 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add stencila/stencila --skill theme-review -g -a claude-code -y`
Codex: `npx skills add stencila/stencila --skill theme-review -g -a codex -y`
Cursor: `npx skills add stencila/stencila --skill theme-review -g -a cursor -y`
Gemini CLI: `npx skills add stencila/stencila --skill theme-review -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add stencila/stencila`

## Description

Critically review an existing or proposed Stencila theme artifact for correctness, token usage, target coverage, cross-target portability, dark-mode handling, maintainability, and approval readiness. Use when asked to review, critique, assess, audit, or validate a theme.css file, theme patch, theme plan, site theme, document theme, plot theme, print or PDF theme, check design tokens, assess DOCX or email behavior, review dark mode support, or validate with stencila themes validate.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 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`](references/themes-guide.md) for theme architecture, resolution rules, and cross-target constraints
- [`references/semantic-and-font-tokens.md`](references/semantic-and-font-tokens.md) for semantic-token and font review guidance
- [`references/node-token-families.md`](references/node-token-families.md) for document/node token families
- [`references/print-and-pdf-tokens.md`](references/print-and-pdf-tokens.md) for print and PDF page tokens
- [`references/plot-tokens.md`](references/plot-tokens.md) for plot theming review
- [`references/site-token-families.md`](references/site-token-families.md) for site-theme component families and naming quirks
- [`references/cli-commands.md`](references/cli-commands.md) for token discovery and validation commands
- [`references/snap-tool.md`](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:

The rest: https://github.com/stencila/stencila/blob/HEAD/.stencila/skills/theme-review/SKILL.md