Agent skill

Docs Site

by mrchantey in mrchantey/beet

Write and edit the public website docs in site/routes/docs (beet.org/docs).

Apache-2.0Auto-check passedFrontend & Design

Install Docs Site

skills CLI
$ npx skills add mrchantey/beet --skill docs-site -a claude-code

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

GitHub CLI
$ gh skill install mrchantey/beet docs-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/mrchantey/beet.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-site .claude/skills/docs-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
docs-site
GitHub stars
135
Token cost
~672 tokens
SKILL.md length
365 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Write and edit the public website docs in site/routes/docs (beet.org/docs).

  • Touching site docs pages
  • SKILL.md covers Audience, Diátaxis first, Tone and Conventions, plus 1 more section
  • Calls cargo; needs OPENAI_API_KEY
  • Tasks that involve Static sites and blogs

What it does

Docs Site is an agent skill from mrchantey/beet. Write and edit the public website docs in site/routes/docs (beet.org/docs). Covers audience, diataxis mode per page, tone, routing conventions and the code-must-be-real rule. Use when touching site docs pages.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Static sites and blogs. The repository describes itself as: A malleable engine built on interoperable standards. The licence is Apache-2.0.

When your agent uses it

  • Touching site docs pages
  • Tasks that involve Static sites and blogs

Example prompts

  • “/docs-site”

Requirements

  • A credential in OPENAI_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 38648b8. 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

    Shell commands in SKILL.md call:

    • cargo

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

  • Network

    Links to these hosts (documentation or services it may open):

    • beet.org

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY

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

Context cost

Docs Site loads about 672 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 365 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~672

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 mrchantey/beet at commit 38648b8, republished under its Apache-2.0 licence (© mrchantey). 365 words, ~672 tokens.

Download SKILL.mdSave it as .claude/skills/docs-site/SKILL.md (or your agent's skills folder).
name
docs-site
description
Write and edit the public website docs in site/routes/docs (beet.org/docs). Covers audience, diataxis mode per page, tone, routing conventions and the code-must-be-real rule. Use when touching site docs pages.

Site docs

How to write and edit the public website docs in site/routes/docs. These are the high-level docs at beet.org, distinct from the crate READMEs and the rustdoc API docs.

Audience

READMEs are for people already working with the API. The website is for people forming a mental model. Aim higher-level: explain the shape of things and why they fit together, link out to the READMEs and docs.rs for detail.

Diátaxis first

Load the docs-diataxis skill and pick one mode per page before writing. Mixing modes is the main cause of bad docs.

  • docs/index.md, docs/crates/* are Explanation: discuss the subject, make connections, give context. Do not instruct.
  • docs/tutorials/* are Tutorials: a guided lesson with a visible result at every step. Do not explain, do not offer choices.

Tone

  • Be cool, not boastful. No "beet's central trick", "the whole point", "that is deliberate", "the clearest demonstration". State what it does and move on. Beet has many good ideas; none of them need a fanfare.
  • Never neg other stacks. Other approaches are valid in their own way. Sell beet on its own terms: malleability and the open Bevy world, not on someone else's expense.
  • No em dashes. No mid-sentence line breaks in markdown, only paragraph breaks.
Show full SKILL.md (161 more words)Show less

Conventions

  • TOML frontmatter for the title: +++\ntitle = "Foo"\n+++.
  • Routes mirror the file tree under site/routes/docs. A new foo.md becomes /docs/foo; nested dirs need an index.md. The sidebar is auto-collected, no manual wiring.
  • Link internally with absolute paths, eg /docs/crates/beet_router.
  • Use language fences (```rust, ```sh) so syntax highlighting works.
  • LLMs love writing text, humans hate reading it. Include exactly what must be there and nothing more. Short code snippets over prose where a snippet says it better.

Code must be real

A tutorial's contract is that every step works for every reader. Ground all code in something verified:

  • Prefer non-ignore README doctests and files under /examples as the basis.
  • Confirm symbols are in the prelude and check the exact feature flags in the root Cargo.toml before telling a reader to cargo add beet --features X. Default features are std, ui only, so most tutorials need to opt in (action, http_server, thread, ...).
  • State real prerequisites up front (eg an OPENAI_API_KEY for agent tutorials).

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

Files

Just SKILL.md in .agents/skills/docs-site of mrchantey/beet.

Open the folder on GitHubat commit 38648b8

Compare with similar skills

Docs 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.

Docs Site compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Site this skillmrchantey/beet135—~672Automated safety check: PassApache-2.0
Tabler Astro Dev Servertabler/tabler42k—~1.2kAutomated safety check: PassMIT
Create Docsvictorgarciaesgi/nuxt-typed-router4132 repos~2.8kAutomated safety check: PassMIT
Tabler Astro Component Scriptstabler/tabler42k—~2.1kAutomated safety check: PassMIT
Paperclip Pagepaperclipai/paperclip99k—~1kAutomated safety check: PassMIT
Kill AI Slopyetone/kill-ai-slop1.3k—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Starts the right Tabler dev server, keeps it from clashing with builds and verifies changes in the browser before a page or component is handed back.

    42k GitHub stars~1.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • 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
  • Rules for adding or fixing client-side scripts in Tabler's Astro components so the copied preview HTML stays readable, self-contained and runs in the right order.

    42k GitHub stars~2.1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Paperclip Page

    paperclipai/paperclip

    Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

    99k GitHub stars~1k tokensUpdated today
    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 23 days ago
    Frontend & DesignAuto-check passed
  • Official

    Audit a documentation site for agent-friendliness: discovery, markdown delivery, crawlability, semantic structure, machine-readable surfaces, and content legibility.

    4.7k GitHub stars~1.8k tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from mrchantey/beet

All 11 skills in this repo
  • Downstream Create

    mrchantey/beet

    Scaffold a new beet downstream repo (beet<name, a sibling of this checkout depending on the beet facade by path) from the template, register it with downstream-sync and run the first sync.

    135 GitHub stars~709 tokensUpdated yesterday
    Auto-check passed
  • Test Examples

    mrchantey/beet

    Run the workspace example smoke set to catch regressions unit tests miss, covering every feature gate combination with self-terminating examples and curl-probed servers.

    135 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Test The Works

    mrchantey/beet

    Maximal project health pass. An agent skill from mrchantey/beet.

    135 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Docs Rust Sweep

    mrchantey/beet

    Comprehensive public-api quality pass over the core crates, reducing pub visibility and documenting every public item to a deny(missingdocs) standard.

    135 GitHub stars~590 tokensUpdated yesterday
    Auto-check passed
  • Infra Deploy

    mrchantey/beet

    The release process for the beet website. An agent skill from mrchantey/beet.

    135 GitHub stars~16k tokensUpdated yesterday
    Auto-check: warnings
  • Downstream Sync

    mrchantey/beet

    Refresh every downstream repo (beetatproto, beetconnect, beetegress, beetesp, beeteval) with beet's AGENTS.md marker block, its MIT/Apache licenses and shared config files.

    135 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about Docs Site

What does Docs Site do?

Write and edit the public website docs in site/routes/docs (beet.org/docs). Docs Site is an agent skill from mrchantey/beet.org/docs).

When should I use Docs Site?

Docs Site fits situations like: touching site docs pages; tasks that involve Static sites and blogs.

How do I install Docs Site in Claude Code?

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

How do I install Docs Site in Codex?

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

Can I use Docs 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 mrchantey/beet --skill docs-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/docs-site, .gemini/skills/docs-site, .github/skills/docs-site and .opencode/skills/docs-site in your project.

What does Docs Site need to run?

Going by SKILL.md and its folder, Docs Site needs the command-line tools its instructions call (cargo) and credentials named OPENAI_API_KEY. Our summary lists: A credential in OPENAI_API_KEY.

Does Docs Site access the network?

SKILL.md names 1 domain. As links in the text: beet.org. This is read from the text; nothing was executed.

Is Docs 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 Docs Site use?

Docs Site is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Docs Site use?

About 672 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Docs Site?

Skills that share tags, products or a category with Docs Site: Tabler Astro Dev Server (tabler/tabler, 42k stars), Create Docs (victorgarciaesgi/nuxt-typed-router, 413 stars), Tabler Astro Component Scripts (tabler/tabler, 42k stars) and Paperclip Page (paperclipai/paperclip, 99k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Site?

mrchantey (a GitHub user) maintains it in mrchantey/beet, which has 135 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 7, 2026.

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