Agent skill

Configure Site

by pymc-labs in pymc-labs/pathmc

Configure a Great Docs documentation site through great-docs.yml.

MITAuto-check passedFrontend & Design

Install Configure Site

skills CLI
$ npx skills add pymc-labs/pathmc --skill configure-site -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pymc-labs/pathmc configure-site --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pymc-labs/pathmc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/configure-site .claude/skills/configure-site && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
configure-site
GitHub stars
132
Token cost
~2k tokens
SKILL.md length
604 words
Files
3 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Configure a Great Docs documentation site through great-docs.yml.

  • Works in 7 steps: Package metadata — module, display_name,… → GitHub integration — repo, github_style,… → Navigation & theming — navbar_style,… → …
  • Customizing site appearance
  • SKILL.md covers Quick start, Skill directory structure, When to use this skill and Core concepts, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Configure Site is an agent skill from pymc-labs/pathmc. Configure a Great Docs documentation site through great-docs.yml. Covers theming (navbar gradients, content glow, dark mode), hero sections, logos, announcements, sidebar options, page tags, page status badges, SEO, analytics, and deployment settings. Use when customizing site appearance, enabling features, or tuning build behavior.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/feature-matrix.md` and `references/theming-options.md`). Compatibility notes: Requires Great Docs =0.8, Quarto CLI installed.

It sits in Frontend & Design, covering Theming and dark mode, Landing pages and Logo and visual identity. The repository describes itself as: Structural causal models with Bayesian estimation and interventional simulation via a concise DSL. The licence is MIT.

When your agent uses it

  • Customizing site appearance
  • Enabling features
  • Tuning build behavior

Example prompts

  • “/configure-site”

Requirements

  • Compatibility (from SKILL.md): Requires Great Docs >=0.8, Quarto CLI installed.

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Package metadata — module, display_name, parser,
  2. GitHub integration — repo, github_style, source
  3. Navigation & theming — navbar_style, navbar_color,
  4. Branding — logo, favicon, hero, announcement
  5. Content — sections, cli, tags, page_status,
  6. Build & publish — versions, skill, changelog, seo,
  7. Author metadata — authors, funding

What it can do on your machine

Read from SKILL.md and the folder at commit e3b9467. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires Great Docs >=0.8, Quarto CLI installed.

    From compatibility in the SKILL.md frontmatter.

Context cost

Configure Site loads about 2k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 87 tokens; SKILL.md has 604 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pymc-labs/pathmc at commit e3b9467, republished under its MIT licence (© pymc-labs). 604 words, ~2,007 tokens.

Download SKILL.mdSave it as .claude/skills/configure-site/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
configure-site
description
Configure a Great Docs documentation site through great-docs.yml. Covers theming (navbar gradients, content glow, dark mode), hero sections, logos, announcements, sidebar options, page tags, page status badges, SEO, analytics, and deployment settings. Use when customizing site appearance, enabling features, or tuning build behavior.
compatibility
Requires Great Docs >=0.8, Quarto CLI installed.
license
MIT
metadata.author
rich-iannone
metadata.version
1.0
metadata.tags
documentation, configuration, theming, deployment

Configure Site

Skill for customizing a Great Docs documentation site through great-docs.yml. All configuration is centralized in this single YAML file at the project root.

Quick start

bash
# Generate a starter config
great-docs init

# Or generate a full template with all options
great-docs config > great-docs.yml

# Edit, then rebuild
great-docs build && great-docs preview

Skill directory structure

skills/configure-site/
├── SKILL.md
└── references/
    ├── theming-options.md
    └── feature-matrix.md

When to use this skill

NeedConfig key
Add a gradient navbarnavbar_style: sky
Set a solid navbar colornavbar_color: "#1a1a2e"
Add content area glowcontent_style: lilac
Add a logologo: assets/logo.svg
Add light/dark logoslogo: {light: ..., dark: ...}
Set a faviconfavicon: assets/favicon.svg
Enable hero sectionhero: true or hero: {enabled: true}
Add starfield animationhero: {starfield: true}
Show announcement bannerannouncement: {content: "...", ...}
Enable dark mode toggledark_mode_toggle: true
Enable page tagstags: {enabled: true}
Enable page status badgespage_status: true
Configure sidebar filtersidebar_filter: {enabled: true}
Set display namedisplay_name: "My Package"
Exclude symbols from docsexclude: [PrivateClass]
Enable CLI documentationcli: {enabled: true, module: ...}
Set docstring parserparser: numpy
Use static analysisdynamic: false
Enable link checkerBuilt-in: great-docs check-links
Add analyticsinclude_in_header: [{text: ...}]
Enable multi-version docsversions: [{label: ..., tag: ...}]

Core concepts

Configuration file location

great-docs.yml must be at the project root, alongside pyproject.toml. Great Docs reads it automatically on every command.

Configuration categories

The config file is organized into logical groups:

  1. Package metadata — module, display_name, parser, dynamic, exclude
  2. GitHub integration — repo, github_style, source
  3. Navigation & theming — navbar_style, navbar_color, content_style, dark_mode_toggle, nav_icons
  4. Branding — logo, favicon, hero, announcement
  5. Content — sections, cli, tags, page_status, sidebar_filter
  6. Build & publish — versions, skill, changelog, seo, include_in_header
  7. Author metadata — authors, funding
Theming presets

Great Docs ships with named gradient presets for the navbar and content area. See references/theming-options.md for the full palette.

yaml
navbar_style: sky       # gradient navbar
content_style: lilac    # content glow

# Or limit content glow to the homepage only:
content_style:
  preset: lilac
  pages: homepage

Available presets: sky, peach, prism, lilac, slate, honey, dusk, mint.

Logo configuration
yaml
# Single logo for both themes
logo: assets/logo.svg

# Separate light/dark logos
logo:
  light: assets/logo-light.svg
  dark: assets/logo-dark.svg
Hero section

The hero is the large landing area on the homepage:

yaml
hero:
  enabled: true
  tagline: "Your tagline here."
  starfield: true # animated starfield canvas

Or use the shorthand: hero: true (uses package description as the tagline).

Announcement banner
yaml
announcement:
  content: "v2 is out! <a href='...'>Read more</a>"
  type: info # info, warning, success, danger
  style: mint # gradient preset (optional)
  dismissable: true # show close button

Shorthand: announcement: "Your message here".

Page tags
yaml
tags:
  enabled: true
  icons:
    Getting Started: rocket
    Configuration: cog
    API: file-code

Pages opt in via frontmatter: tags: [Getting Started, API].

Page status badges
yaml
page_status: true

Pages set their status in frontmatter:

yaml
---
title: "New Feature"
status: experimental # experimental, new, stable, deprecated
---
Navigation icons

Add Lucide icons to navbar and sidebar labels:

yaml
nav_icons:
  navbar:
    User Guide: book-open
    Reference: code
  sidebar:
    Installation: download
    Quick Start: rocket
Multi-version documentation
yaml
versions:
  - label: "2.0 (dev)"
    tag: dev
    version: "2.0.0"
    prerelease: true
  - label: "1.0"
    tag: "1.0"
    git_ref: v1.0.0
    latest: true
  - label: "0.9"
    tag: "0.9"
    git_ref: v0.9
    eol: true # end-of-life badge
SEO
yaml
seo:
  sitemap: true
  canonical:
    base_url: https://your-package.readthedocs.io/
  meta:
    description: "Custom meta description"
Excluding symbols
yaml
exclude:
  - _InternalClass
  - deprecated_function
  - Config # re-exported third-party type

Workflows

Show full SKILL.md (262 more words)Show less
Setting up a new site's appearance
Task Progress:
- [ ] Step 1: Choose a navbar style
- [ ] Step 2: Set content glow
- [ ] Step 3: Add logo and favicon
- [ ] Step 4: Configure hero section
- [ ] Step 5: Build and preview

Step 1: Pick a navbar_style preset. Preview each by building.

Step 2: Set content_style to a complementary preset.

Step 3: Add SVG or PNG logo files to assets/ and configure the logo key. Set favicon similarly.

Step 4: Enable hero with a tagline. Add starfield: true for the animated background.

Step 5: Run great-docs build && great-docs preview.

Enabling a feature
  1. Find the relevant config key (use the table above or references/feature-matrix.md).
  2. Add it to great-docs.yml.
  3. Rebuild with great-docs build.
  4. Check the rendered output in the browser.
Migrating from a minimal config

If you started with great-docs init and want to add more features:

  1. Run great-docs config to see all available options.
  2. Copy the sections you want into your existing great-docs.yml.
  3. Customize values.
  4. Rebuild.

Gotchas

  1. YAML indentation matters. Use 2-space indentation. Tabs cause parse errors.
  2. module is the import name. For PyPI package py-shiny, set module: shiny, not module: py-shiny.
  3. Preset names are case-sensitive. Use lowercase: sky, not Sky.
  4. hero: true is shorthand. For full control, use the dict form with enabled, tagline, and starfield keys.
  5. Logo paths are relative to the project root. Not relative to great-docs.yml.
  6. content_style on homepage only. Use the dict form with pages: homepage to avoid the glow on every page.
  7. Changes require rebuild. Config changes are not hot-reloaded. Always run great-docs build after editing great-docs.yml.
  8. Version git_ref must exist. The tag or branch must exist in the Git repository or the versioned build will fail.

© pymc-labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .agents/skills/configure-site of pymc-labs/pathmc.

  • SKILL.md
  • references/feature-matrix.md
  • references/theming-options.md

Open the folder on GitHubat commit e3b9467

Compare with similar skills

Configure Site next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Configure Site compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Configure Site this skillpymc-labs/pathmc132—~2kAutomated safety check: PassMIT
Bryl Minimal Designbryllim/bryl-minimal-design115—~2.9kAutomated safety check: PassMIT
Impeccablebestofjs/bestofjs3.1k26 repos~2.6kAutomated safety check: PassMIT
UI UX Pro Maxsaoudi-h/solar-icons19018 repos~11kAutomated safety check: NotesCustom licence
Create Docsvictorgarciaesgi/nuxt-typed-router4132 repos~2.8kAutomated safety check: PassMIT
Kill AI Slopyetone/kill-ai-slop1.3k—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Bryl Minimal Design

    bryllim/bryl-minimal-design

    Apply the bryl-minimal design language — a monochrome, typography-driven minimal aesthetic with halftone dot textures, pixel-font display headings, tiny uppercase monospace labels, soft large-radius…

    115 GitHub stars~2.9k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 26 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • UI UX Pro Max

    saoudi-h/solar-icons

    UI/UX design intelligence for web and mobile. An agent skill from saoudi-h/solar-icons.

    190 GitHub starsUsed in 18 repos~11k tokens
    Frontend & DesignAuto-check: notes
  • Create Docs

    victorgarciaesgi/nuxt-typed-router

    Create complete documentation sites for projects. An agent skill from victorgarciaesgi/nuxt-typed-router.

    413 GitHub starsUsed in 2 repos~2.8k tokens
    Frontend & DesignAuto-check passed
  • Kill AI Slop

    yetone/kill-ai-slop

    Find and remove AI slop — the generic, machine-default visual and copy tics of vibe-coded products — from a web project.

    1.3k GitHub stars~1.4k tokensUpdated 26 days ago
    Frontend & DesignAuto-check passed
  • Static Sites

    bionic-gpt/bionic-gpt

    Create or modify Bionic's generated marketing site, documentation, blog, course pages, and static assets.

    2.4k GitHub stars~920 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed

More from pymc-labs/pathmc

  • Great Docs

    pymc-labs/pathmc

    Generate documentation sites for Python packages with Great Docs.

    132 GitHub stars~2.7k tokensUpdated 8 days ago
    Auto-check passed
  • Author Skills

    pymc-labs/pathmc

    Author, configure, and distribute Agent Skills for a Great Docs site.

    132 GitHub stars~2.6k tokensUpdated 8 days ago
    Auto-check passed
  • Revise Docstrings

    pymc-labs/pathmc

    Review and improve Python docstrings for Great Docs API reference generation.

    132 GitHub stars~2.3k tokensUpdated 8 days ago
    Auto-check passed
  • Write User Guide

    pymc-labs/pathmc

    Write and maintain narrative user-guide pages for a Great Docs site.

    132 GitHub stars~2.3k tokensUpdated 8 days ago
    Auto-check passed
  • Fix Bug

    pymc-labs/pathmc

    Autonomous bug-fix workflow. An agent skill from pymc-labs/pathmc.

    132 GitHub stars~4.6k tokensUpdated 8 days ago
    Auto-check passed
  • Pathmc

    pymc-labs/pathmc

    Bayesian path analysis (observed-variable SEM) in PyMC. An agent skill from pymc-labs/pathmc.

    132 GitHub stars~4k tokensUpdated 8 days ago
    Auto-check passed

Questions about Configure Site

What does Configure Site do?

Configure a Great Docs documentation site through great-docs.yml. Configure Site is an agent skill from pymc-labs/pathmc.yml.

When should I use Configure Site?

Configure Site fits situations like: customizing site appearance; enabling features; tuning build behavior.

How do I install Configure Site in Claude Code?

Run `npx skills add pymc-labs/pathmc --skill configure-site -a claude-code`. Or copy the skill folder (.agents/skills/configure-site in pymc-labs/pathmc) into .claude/skills/configure-site in your project. Claude Code loads it when a task matches its description.

How do I install Configure Site in Codex?

Run `npx skills add pymc-labs/pathmc --skill configure-site -a codex`. Or copy the skill folder (.agents/skills/configure-site in pymc-labs/pathmc) into .agents/skills/configure-site in your project. Codex loads it when a task matches its description.

Can I use Configure Site in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pymc-labs/pathmc --skill configure-site -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/configure-site, .gemini/skills/configure-site, .github/skills/configure-site and .opencode/skills/configure-site in your project.

What does Configure Site need to run?

SKILL.md names no scripts, command-line tools or credentials: Configure Site is instructions for the agent only. Compatibility (from SKILL.md): Requires Great Docs >=0.8, Quarto CLI installed..

Does Configure Site access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Configure Site safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Configure Site use?

Configure Site is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Configure Site use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Configure Site?

Skills that share tags, products or a category with Configure Site: Bryl Minimal Design (bryllim/bryl-minimal-design, 115 stars), Impeccable (bestofjs/bestofjs, 3.1k stars), UI UX Pro Max (saoudi-h/solar-icons, 190 stars) and Create Docs (victorgarciaesgi/nuxt-typed-router, 413 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Configure Site?

pymc-labs (a GitHub organization) maintains it in pymc-labs/pathmc, which has 132 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 2, 2026.

Source: pymc-labs/pathmc on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.