theme-review

Review Stencila theme.css files for correctness, token usage, and cross-target compatibility.

900|58|Updated May 31, 2012
One-click install
npx skills add https://github.com/stencila/stencila --skill theme-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theme-review
Source: https://github.com/stencila/stencila/tree/main/.stencila/skills/theme-review
Command: npx skills add https://github.com/stencila/stencila --skill theme-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that Stencila themes are correct, maintainable, and meet design standards before implementation or deployment.

Core Features & Use Cases

  • Theme Validation: Assesses CSS theme files for correctness, token usage, and adherence to Stencila's theming guidelines.
  • Cross-Target Compatibility: Checks how themes will behave across different outputs like web, PDF, and DOCX.
  • Use Case: You've created a new theme.css file for your Stencila project and want to ensure it's robust and portable. Use this Skill to get a detailed review of its quality and identify potential issues.

Quick Start

Use the theme-review skill to review the attached file 'my-custom-theme.css'.

Frequently Asked Questions about theme-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate CSS design tokens in a Stencila theme?

You can validate CSS design tokens by analyzing your theme.css file against Stencila's theming architecture. This process checks token usage, CSS rule correctness, and cross-target constraints for web, PDF, and DOCX outputs.

How do I check if my CSS theme is portable across web, PDF, and DOCX outputs?

Checking CSS theme portability involves analyzing your theme.css file for cross-target compatibility. The review assesses how design tokens and CSS rules behave across web, PDF, and DOCX outputs to ensure consistent rendering.

What is a theme review for CSS files?

A theme review evaluates CSS theme files for correctness, token usage, target coverage, portability, and maintainability. It analyzes theme.css files or patches against architectural guidelines to determine approval readiness before deployment.

Can I review a CSS theme patch for maintainability before applying it?

Yes, you can review a CSS theme patch for maintainability before applying it. The review process analyzes patches or plans against Stencila's theming architecture, validating token usage and CSS rules to ensure long-term quality.

Does Stencila theme review require any external dependencies or CLI tools?

Stencila theme review uses local references and CLI commands to validate token usage and CSS rules. It operates within the Stencila ecosystem without requiring external dependencies, relying on built-in references for approval readiness checks.