Agent skill

Docs Site

by pambrose in pambrose/prometheus-proxy

A skill your agent uses when editing, building, previewing, or deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config, code-snippet resolution…

Apache-2.0Auto-check passedDevOps & Cloud

Install Docs Site

skills CLI
$ npx skills add pambrose/prometheus-proxy --skill docs-site -a claude-code

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

GitHub CLI
$ gh skill install pambrose/prometheus-proxy 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/pambrose/prometheus-proxy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/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
157
Token cost
~250 tokens
SKILL.md length
70 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when editing, building, previewing, or deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config, code-snippet resolution…

  • Deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config
  • Calls make and uv
  • Code-snippet resolution

What it does

Docs Site is an agent skill from pambrose/prometheus-proxy. Use when editing, building, previewing, or deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config, code-snippet resolution, local preview, and CI deploy.

Its SKILL.md is about 250 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 DevOps & Cloud, covering Static sites and blogs and Monitoring and alerting. It works with Prometheus, Kotlin and gRPC. The licence is Apache-2.0.

When your agent uses it

  • Deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config
  • Code-snippet resolution

Example prompts

  • “/docs-site”

What it can do on your machine

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

    • make
    • uv

    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):

    • zensical.org

    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.

Context cost

Docs Site loads about 250 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 70 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
~250

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 pambrose/prometheus-proxy at commit bcaf988, republished under its Apache-2.0 licence (© pambrose). 70 words, ~250 tokens.

Download SKILL.mdSave it as .claude/skills/docs-site/SKILL.md (or your agent's skills folder).
name
docs-site
description
Use when editing, building, previewing, or deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config, code-snippet resolution, local preview, and CI deploy.

Documentation site

Documentation is built with Zensical (static site generator) and lives in website/prometheus-proxy/.

  • Config: website/prometheus-proxy/zensical.toml
  • Pages: website/prometheus-proxy/docs/ (Markdown with pymdownx extensions)
  • Code snippets: src/test/kotlin/website/*.txt (imported via --8<-- snippet markers)
  • Local preview: make site (runs cd website/prometheus-proxy && uv run --with mkdocs-material zensical serve)
  • CI deploy: .github/workflows/docs.yml (builds and deploys to GitHub Pages)

Snippets use dual base_path in zensical.toml: first resolves .txt files from src/test/kotlin/website/, second resolves project-root files like examples/*.conf.

© pambrose, 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 .claude/skills/docs-site of pambrose/prometheus-proxy.

Open the folder on GitHubat commit bcaf988

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 skillpambrose/prometheus-proxy157—~250Automated safety check: PassApache-2.0
Beylagrafana/skills279—~1.1kAutomated safety check: PassApache-2.0
Prometheus Error Rate Investigatorprometheus/prometheus-mcp118—~592Automated safety check: PassApache-2.0
Kratos Developmentaide-family/moon253—~1.5kAutomated safety check: PassNone
Syncmetapawurb/hotpath-rs1.9k—~1.2kAutomated safety check: NotesMIT
Optimize Slurm TopologyNVlabs/alpasim1.3k—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Beyla

    grafana/skills

    Official

    Auto-instrument an application's HTTP / gRPC / DB traffic with Grafana Beyla eBPF — no code changes, no SDK, no restart.

    279 GitHub stars~1.1k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Prometheus Error Rate Investigator

    prometheus/prometheus-mcp

    Quantifies elevated error rates with PromQL, compares them to a baseline, and isolates which jobs or instances an error spike is concentrated in.

    118 GitHub stars~592 tokensUpdated 4 days ago
    DevOps & CloudAuto-check passed
  • Kratos Development

    aide-family/moon

    Develops Go microservices with Kratos v2 following official design philosophy, DDD/Clean Architecture layout, Protobuf API, error/config/middleware patterns, and observability.

    253 GitHub stars~1.5k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • Syncmeta

    pawurb/hotpath-rs

    Sync changes from the hotpath, hotpath-macros and hotpath-drain crates to their meta counterparts (hotpath-meta, hotpath-macros-meta and hotpath-drain-meta).

    1.9k GitHub stars~1.2k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Optimize AlpaSim Slurm topology throughput using persistent local Prometheus/Grafana telemetry and run artifacts.

    1.3k GitHub stars~1.6k tokensUpdated 20 days ago
    DevOps & CloudAuto-check passed
  • Greptimedb Perses Dashboard

    GreptimeTeam/dashboard

    Generate Perses dashboards or single panels for GreptimeDB. An agent skill from GreptimeTeam/dashboard.

    111 GitHub stars~3.9k tokensUpdated 8 days ago
    DevOps & CloudAuto-check passed

More from pambrose/prometheus-proxy

  • Publishing Release

    pambrose/prometheus-proxy

    A skill your agent uses when publishing prometheus-proxy to Maven Central, cutting a release, running a snapshot publish, or bumping the project version — covers the Maven Central coordinates, GPG…

    157 GitHub stars~506 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Docs Site

What does Docs Site do?

A skill your agent uses when editing, building, previewing, or deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config, code-snippet resolution…. Docs Site is an agent skill from pambrose/prometheus-proxy. Use when editing, building, previewing, or deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config, code-snippet resolution, local preview, and CI deploy.

When should I use Docs Site?

Docs Site fits situations like: deploying the prometheus-proxy documentation site under website/prometheus-proxy — covers the Zensical config; code-snippet resolution.

How do I install Docs Site in Claude Code?

Run `npx skills add pambrose/prometheus-proxy --skill docs-site -a claude-code`. Or copy the skill folder (.claude/skills/docs-site in pambrose/prometheus-proxy) 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 pambrose/prometheus-proxy --skill docs-site -a codex`. Or copy the skill folder (.claude/skills/docs-site in pambrose/prometheus-proxy) 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 pambrose/prometheus-proxy --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 (make and uv).

Does Docs Site access the network?

SKILL.md names 1 domain. As links in the text: zensical.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 250 tokens (SKILL.md is roughly 1k 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: Beyla (grafana/skills, 279 stars), Prometheus Error Rate Investigator (prometheus/prometheus-mcp, 118 stars), Kratos Development (aide-family/moon, 253 stars) and Syncmeta (pawurb/hotpath-rs, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Site?

pambrose (a GitHub user) maintains it in pambrose/prometheus-proxy, which has 157 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 7, 2026.

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