Agent skill

Docs Review

by jtenniswood in jtenniswood/espcontrol

Review EspControl repository changes specifically for missing, stale, excessive, or misplaced documentation.

Custom licenceAuto-check passedDevelopment

Install Docs Review

skills CLI
$ npx skills add jtenniswood/espcontrol --skill docs-review -a claude-code

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

GitHub CLI
$ gh skill install jtenniswood/espcontrol docs-review --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/jtenniswood/espcontrol.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-review .claude/skills/docs-review && 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-review
GitHub stars
1.1k
Token cost
~805 tokens
SKILL.md length
378 words
Files
2
Skills in repo
14
Repo updated
First seen
Licence
Custom licence

At a glance

Review EspControl repository changes specifically for missing, stale, excessive, or misplaced documentation.

  • Works in 5 steps: Read the request, PR summary, changed… → Compare the diff with likely EspControl… → Decide whether documentation is needed.… → …
  • The user asks for a documentation coverage review
  • SKILL.md covers Workflow, Ask For Docs When The Change, Prefer Concise Placement and Output
  • Calls npm

What it does

Docs Review is an agent skill from jtenniswood/espcontrol. Review EspControl repository changes specifically for missing, stale, excessive, or misplaced documentation. Use when the user asks for a documentation coverage review, asks whether a feature or behavior change is concisely documented, invokes $docs-review, or explicitly wants docs checked as a secondary pass during a pull request, branch, or local diff review.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Pull requests. It works with Home Assistant. The repository describes itself as: Esphome based smart home control panel.

When your agent uses it

  • The user asks for a documentation coverage review
  • Asks whether a feature
  • Behavior change is concisely documented
  • Invokes $docs-review

Example prompts

  • “/docs-review”

Workflow steps

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

  1. Read the request, PR summary, changed files, and tests.
  2. Compare the diff with likely EspControl documentation targets
  3. Decide whether documentation is needed. Do not ask for docs when the change
  4. Report only actionable documentation findings, ordered by importance.
  5. Suggest the smallest useful update: usually one sentence, one bullet, one

What it can do on your machine

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

    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    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 Review loads about 805 tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 378 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 378 words (~805 tokens).

“Review documentation coverage without turning every code change into a writing task. Require docs only when a user, tester, or maintainer would reasonably need the information to install, configure, test, troubleshoot, upgrade, release, or maintain the change.”

— opening of SKILL.md by jtenniswood, Custom licence
name
docs-review

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/docs-review of jtenniswood/espcontrol.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 24ce042

Compare with similar skills

Docs Review 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 Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Review this skilljtenniswood/espcontrol1.1k—~805Automated safety check: PassCustom licence
Community Triageroryeckel/wyoming_openai219—~2.9kAutomated safety check: PassApache-2.0
simon42 Dashboard Strategy Dev GuideTheRealSimon42/simon42-dashboard-strategy265—~3.6kAutomated safety check: PassCustom licence
PR Descriptiongduteil/cozytouch128—~539Automated safety check: PassNone
PR Bodyandrew-blake/melcloudhome142—~4.5kAutomated safety check: PassMIT
Huawei PRxiasi0/ha-huawei-smarthome135—~501Automated safety check: PassGPL-3.0

Similar skills

  • Community Triage

    roryeckel/wyoming_openai

    GitHub issues, pull requests, bug reports, scope questions, and support threads.

    219 GitHub stars~2.9k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • simon42 Dashboard Strategy Dev Guide

    TheRealSimon42/simon42-dashboard-strategy

    Working rules for developing the simon42 Home Assistant dashboard strategy: verify before assuming, protect existing behavior, test on a real system and handle community PRs with care.

    265 GitHub stars~3.6k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • PR Description

    gduteil/cozytouch

    Write or rewrite a pull request description so it is short and actually readable.

    128 GitHub stars~539 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • PR Body

    andrew-blake/melcloudhome

    A skill your agent uses when composing or revising a pull request description in this repo, including PRs that sit in a stack.

    142 GitHub stars~4.5k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Huawei PR

    xiasi0/ha-huawei-smarthome

    Standardize pull request titles and descriptions for the ha-huawei-smarthome repository.

    135 GitHub stars~501 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Verify Cozytouch

    gduteil/cozytouch

    Prove a change to the Cozytouch Home Assistant integration in a real Home Assistant — a throwaway instance against a fake Atlantic cloud served from a diagnostics dump (a fixture or a reporter's)…

    128 GitHub stars~2.2k tokensUpdated 4 days ago
    DevelopmentAuto-check passed

More from jtenniswood/espcontrol

All 14 skills in this repo
  • Clean Complete Branches

    jtenniswood/espcontrol

    Clean up completed Git branches and worktrees for this repository both locally and on GitHub.

    1.1k GitHub stars~820 tokensUpdated today
    Auto-check passed
  • Clean Merged Branch Folders

    jtenniswood/espcontrol

    Clean up local branch worktree folders for this repository after their branches or pull requests have merged to main.

    1.1k GitHub stars~813 tokensUpdated today
    Auto-check passed
  • Flash Displays

    jtenniswood/espcontrol

    Flash EspControl display firmware from this repository using ESPHome.

    1.1k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • PR

    jtenniswood/espcontrol

    Review a new or open pull request for this repository with an adversarial security and quality lens.

    1.1k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Release

    jtenniswood/espcontrol

    Create and safely publish a new GitHub release for this repository through a verified draft build, then confirm the related GitHub Actions run.

    1.1k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Review All

    jtenniswood/espcontrol

    Review every open pull request authored by the user in this repository and address actionable unresolved review feedback.

    1.1k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Docs Review

What does Docs Review do?

Review EspControl repository changes specifically for missing, stale, excessive, or misplaced documentation. Docs Review is an agent skill from jtenniswood/espcontrol. Review EspControl repository changes specifically for missing, stale, excessive, or misplaced documentation.

When should I use Docs Review?

Docs Review fits situations like: the user asks for a documentation coverage review; asks whether a feature; behavior change is concisely documented; invokes $docs-review.

How do I install Docs Review in Claude Code?

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

How do I install Docs Review in Codex?

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

Can I use Docs Review 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 jtenniswood/espcontrol --skill docs-review -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-review, .gemini/skills/docs-review, .github/skills/docs-review and .opencode/skills/docs-review in your project.

What does Docs Review need to run?

Going by SKILL.md and its folder, Docs Review needs the command-line tools its instructions call (npm).

Does Docs Review access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

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

Docs Review has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Docs Review use?

About 805 tokens (SKILL.md is roughly 3.2k 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 Review?

Skills that share tags, products or a category with Docs Review: Community Triage (roryeckel/wyoming_openai, 219 stars), simon42 Dashboard Strategy Dev Guide (TheRealSimon42/simon42-dashboard-strategy, 265 stars), PR Description (gduteil/cozytouch, 128 stars) and PR Body (andrew-blake/melcloudhome, 142 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Review?

jtenniswood (a GitHub user) maintains it in jtenniswood/espcontrol, which has 1,091 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 9, 2026.

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