# Site Config Creation

Create or update the [site] section of stencila.toml for published Stencila sites.

- 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-creation -g -a claude-code -y`
Codex: `npx skills add stencila/stencila --skill site-config-creation -g -a codex -y`
Cursor: `npx skills add stencila/stencila --skill site-config-creation -g -a cursor -y`
Gemini CLI: `npx skills add stencila/stencila --skill site-config-creation -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add stencila/stencila`

## Description

Create or update the [site] section of stencila.toml for published Stencila sites. Use when asked to configure site domain, title, author, logo, icons, labels, descriptions, socials, featured content, navigation, routes, access, layout presets and regions, glide, search, formats, reviews, uploads, remotes, actions, auto-index, or specimen. Covers reading existing TOML, generating valid configuration, editing while preserving comments and formatting, and snap-based visual verification.

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

## Overview

Help the user create or update the `[site]` section of `stencila.toml` for a published Stencila site. This skill covers all site configuration subsections, from basic metadata (domain, title, author) through navigation, layout, search, access control, and interactive features (reviews, uploads, remotes).

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                                                  |
| -------------------------------- | -------- | ------------------------------------------------------------ |
| User's site configuration goals  | Required | What the user wants to configure (domain, layout, nav, etc.) |
| Existing `stencila.toml` content | Required | Current file content (read from workspace)                   |
| Asset paths (logos, images)      | Optional | Paths to logo files, social images, etc.                     |

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

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