Agent skill

Review Docs

by JamieMason in JamieMason/syncpack

Review and improve Syncpack documentation for clarity, completeness, and consistency.

MITAuto-check passedDevelopment

Install Review Docs

skills CLI
$ npx skills add JamieMason/syncpack --skill review-docs -a claude-code

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

GitHub CLI
$ gh skill install JamieMason/syncpack review-docs --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/JamieMason/syncpack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/review-docs .claude/skills/review-docs && 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
review-docs
GitHub stars
2.1k
Token cost
~559 tokens
SKILL.md length
239 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Review and improve Syncpack documentation for clarity, completeness, and consistency.

  • Works in 5 steps: Read the documentation file → Cross-reference structure with similar… → Identify information gaps where users… → …
  • Validating before publication
  • SKILL.md covers When to Use, Related Skills, Your Task and Quality Checklist, plus 3 more sections
  • Calls pnpm

What it does

Review Docs is an agent skill from JamieMason/syncpack. Review and improve Syncpack documentation for clarity, completeness, and consistency. Use when enhancing docs or validating before publication.

Its SKILL.md is about 560 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 Development. It works with pnpm. The repository describes itself as: Consistent dependency versions in large JavaScript Monorepos. The licence is MIT.

When your agent uses it

  • Validating before publication

Example prompts

  • “/review-docs”

Workflow steps

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

  1. Read the documentation file
  2. Cross-reference structure with similar docs
  3. Identify information gaps where users might get stuck
  4. Check for shared partials at site/src/_partials/
  5. Apply signal-over-noise: Can you cut 20% of words without losing meaning?

What it can do on your machine

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

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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

Review Docs loads about 559 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 239 words of instructions outside code blocks.

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

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 JamieMason/syncpack at commit 958d306, republished under its MIT licence (© JamieMason). 239 words, ~559 tokens.

Download SKILL.mdSave it as .claude/skills/review-docs/SKILL.md (or your agent's skills folder).
name
review-docs
description
Review and improve Syncpack documentation for clarity, completeness, and consistency. Use when enhancing docs or validating before publication.

Review Docs

Review and improve Syncpack documentation against project standards.

When to Use

  • Validating docs before publication
  • Improving existing documentation
  • Ensuring consistency across pages
  • User reports documentation is unclear

Use with:

  • document-code — Reference for structure and locations
  • signal-over-noise — Apply to remove filler and obvious explanations
  • front-loading — Ensure actionable information comes first

Your Task

Given a documentation path, review content against standards. Suggest concrete improvements.

Quality Checklist

  • Clarity: First line immediately shows what it covers
  • Examples: Practical, show real use cases, cover major patterns
  • Completeness: All relevant aspects documented
  • Consistency: Formatting matches other docs
  • Conciseness: No fluff; every sentence earns space
  • Accessibility: Users find what they need without deep reading
  • Reuse: Reference shared partials when available

Review Process

  1. Read the documentation file
  2. Cross-reference structure with similar docs
  3. Identify information gaps where users might get stuck
  4. Check for shared partials at site/src/_partials/
  5. Apply signal-over-noise: Can you cut 20% of words without losing meaning?

Review Output

Provide structured feedback:

Current State

  • Assessment of documentation quality and coverage

Issues Found

  • Specific problems with locations (section names or line references)
  • Prioritize by impact: clarity > completeness > polish

Recommendations

  • Concrete improvements with examples
  • Rewrite short sections if needed
  • Flag missing content or examples
  • Suggest shared partials to reuse

Priority Actions

  • Top 2-3 changes to make immediately

Reference

Docs: site/src/content/docs/ Shared partials: site/src/_partials/ Source of truth: src/ (Rust implementation) Local testing: cd site && pnpm run dev then verify at http://localhost:4321/syncpack

© JamieMason, MIT. 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/review-docs of JamieMason/syncpack.

Open the folder on GitHubat commit 958d306

Compare with similar skills

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

Review Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Review Docs this skillJamieMason/syncpack2.1k—~559Automated safety check: PassMIT
@pierre/diffs Code Renderingpierrecomputer/pierre6.2k2 repos~803Automated safety check: PassApache-2.0
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
Link Workspace Packagesnomcopter/react-mosaic4.8k6 repos~760Automated safety check: PassCustom licence
Pull Requestspnpm/pnpm37k—~2.2kAutomated safety check: PassMIT
Release Notespnpm/pnpm37k—~2.8kAutomated safety check: PassMIT

Similar skills

  • @pierre/diffs Code Rendering

    pierrecomputer/pierre

    Guides an agent through using @pierre/diffs to render syntax-highlighted files and diffs, and to build editing and review surfaces in React or plain JavaScript.

    6.2k GitHub starsUsed in 2 repos~803 tokens
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Link Workspace Packages

    nomcopter/react-mosaic

    Link workspace packages in monorepos (npm, yarn, pnpm, bun).

    4.8k GitHub starsUsed in 6 repos~760 tokens
    DevelopmentAuto-check passed
  • Pull Requests

    pnpm/pnpm

    Take a change through a pull request in the pnpm repository — opening it, then staying with it after every push until CI is green and the review round is quiet.

    37k GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release Notes

    pnpm/pnpm

    Curate a pending release page - merging entries that describe one change, dropping notes for defects that never shipped, ordering by importance, and checking the version the intents ask for.

    37k GitHub stars~2.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from JamieMason/syncpack

All 11 skills in this repo
  • Document Code

    JamieMason/syncpack

    Add and update the documentation website for Syncpack. An agent skill from JamieMason/syncpack.

    2.1k GitHub stars~1.3k tokensUpdated 12 days ago
    Auto-check passed
  • Fix Bug

    JamieMason/syncpack

    Debug and fix bugs in Syncpack using scientific debugging methodology.

    2.1k GitHub stars~1.2k tokensUpdated 12 days ago
    Auto-check passed
  • Front Loading

    JamieMason/syncpack

    Put the answer first, then context and details follow. An agent skill from JamieMason/syncpack.

    2.1k GitHub stars~1.9k tokensUpdated 12 days ago
    Auto-check passed
  • Search Code

    JamieMason/syncpack

    Search for code patterns in Syncpack. An agent skill from JamieMason/syncpack.

    2.1k GitHub stars~581 tokensUpdated 12 days ago
    Auto-check passed
  • Signal Over Noise

    JamieMason/syncpack

    Maximize useful information per word by removing filler, obvious explanations, and hedging language.

    2.1k GitHub stars~1.5k tokensUpdated 12 days ago
    Auto-check passed
  • Testing Gaps

    JamieMason/syncpack

    Run coverage, inspect results, and identify missing test scenarios for a given source file.

    2.1k GitHub stars~766 tokensUpdated 12 days ago
    Auto-check passed

Works with

Categories

Questions about Review Docs

What does Review Docs do?

Review and improve Syncpack documentation for clarity, completeness, and consistency. Review Docs is an agent skill from JamieMason/syncpack. Review and improve Syncpack documentation for clarity, completeness, and consistency.

When should I use Review Docs?

Review Docs fits situations like: validating before publication.

How do I install Review Docs in Claude Code?

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

How do I install Review Docs in Codex?

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

Can I use Review Docs 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 JamieMason/syncpack --skill review-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/review-docs, .gemini/skills/review-docs, .github/skills/review-docs and .opencode/skills/review-docs in your project.

What does Review Docs need to run?

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

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

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

How many tokens does Review Docs use?

About 559 tokens (SKILL.md is roughly 2.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 Review Docs?

Skills that share tags, products or a category with Review Docs: @pierre/diffs Code Rendering (pierrecomputer/pierre, 6.2k stars), React Router Release Notes Prep (remix-run/react-router, 57k stars), Link Workspace Packages (nomcopter/react-mosaic, 4.8k stars) and Pull Requests (pnpm/pnpm, 37k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Review Docs?

JamieMason (a GitHub user) maintains it in JamieMason/syncpack, which has 2,099 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 26, 2026.

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