# Site Config Review

Review a Stencila site configuration (stencila.toml) for correctness, completeness...

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

## Install

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

## Description

Review a Stencila site configuration (stencila.toml) for correctness, completeness, best practices, and rendered appearance. Use when asked to review, audit, validate, check, or assess a site config, stencila.toml, site routes, redirects, site layout, layout presets, site nav, navigation, site access, access control, or site deployment readiness.

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

## Overview

Review a Stencila site configuration (`stencila.toml`) for structural correctness, route validity, dependency completeness, layout quality, best practices, and rendered appearance. The primary mode is **assess and report**: identify concrete issues, missing configuration, risky assumptions, and deployment blockers.

This is a **review-only skill**. Do not use it to create a new site configuration from scratch. Use it when the user wants an assessment of an existing `stencila.toml` or a proposed configuration change.

Use these references:

- [`references/site-configuration.md`](references/site-configuration.md) for the complete field reference with types, defaults, and examples for every subsection

- [`references/snap-tool.md`](references/snap-tool.md) for visual verification of layout and component changes

Use `stencila config check` to validate the configuration.

Use `stencila config show` to inspect the resolved configuration after validation and verify that changes took effect as intended.

## Required Inputs

| Input | Required | Description |
|---|---|---|
| Site config file | Required | Path to `stencila.toml` or the config content to review |
| Review scope | Optional | Focus area: full review, routes only, layout only, etc. |
| Deployment target | Optional | Whether the site targets Stencila Cloud, self-hosted, or local preview |

When used standalone, these inputs come from the user or the agent's prompt. When used within a workflow, the workflow's stage prompt will specify how to obtain them.

## Outputs

| Output | Description |
|---|---|
| Review findings | Prioritized list of blocking, important, and optional findings |
| Verdict | Overall assessment: ready to deploy, acceptable with caveats, or not ready |

## Review Dimensions

Evaluate the configuration against these dimensions:

### 1. Structural Validation

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