Agent skill

Documentation Maintenance

by bradygaster in bradygaster/squad

Maintain accurate, scannable Squad documentation with validated inventory and links

MITAuto-check passed

Install Documentation Maintenance

skills CLI
$ npx skills add bradygaster/squad --skill documentation-maintenance -a claude-code

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

GitHub CLI
$ gh skill install bradygaster/squad documentation-maintenance --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/bradygaster/squad.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.copilot/skills/documentation-maintenance .claude/skills/documentation-maintenance && 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
documentation-maintenance
GitHub stars
3.3k
Token cost
~425 tokens
SKILL.md length
183 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Maintain accurate, scannable Squad documentation with validated inventory and links

  • SKILL.md covers Context, Patterns, Examples and Anti-Patterns
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Documentation Maintenance is an agent skill from bradygaster/squad. Maintain accurate, scannable Squad documentation with validated inventory and links

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

The repository describes itself as: Squad: AI agent teams for any project. The licence is MIT.

Example prompts

  • “/documentation-maintenance”

What it can do on your machine

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

    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.

Context cost

Documentation Maintenance loads about 425 tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 183 words of instructions outside code blocks.

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

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 bradygaster/squad at commit 1fd7e03, republished under its MIT licence (© bradygaster). 183 words, ~425 tokens.

Download SKILL.mdSave it as .claude/skills/documentation-maintenance/SKILL.md (or your agent's skills folder).
name
documentation-maintenance
description
Maintain accurate, scannable Squad documentation with validated inventory and links
domain
documentation
confidence
high
source
current documentation tests and repository requirements

Context

Use this skill when adding, removing, or materially changing user-facing documentation. Squad documentation should describe the product and its supported configuration, not surrounding infrastructure presented as product behavior.

Patterns

  • Follow the Microsoft Style Guide: sentence-case headings, active voice, second person, and present tense unless established project voice requires an exception.
  • Keep one canonical page per concept. Link to it rather than duplicating content, using the most specific stable anchor available.
  • Choose paragraphs for explanation, parallel lists for scannable choices or steps, and tables for comparisons or reference data.
  • When a page is added or removed, update the relevant expected-inventory arrays in test/docs-build.test.ts in the same change.
  • Review behavior changes for documentation impact. Update affected docs or explicitly record why no user-facing documentation changes.

Examples

.github/PR_REQUIREMENTS.md requires a docs-build test update for a new feature page. test/docs-build.test.ts verifies the expected guide, feature, scenario, concept, and reference inventories against the filesystem.

Anti-Patterns

  • Presenting external deployment wrappers, bots, or unrelated infrastructure as Squad features
  • Adding a page without checking the inventory assertions
  • Duplicating a concept across several pages instead of linking to the canonical explanation

© bradygaster, 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 .copilot/skills/documentation-maintenance of bradygaster/squad.

Open the folder on GitHubat commit 1fd7e03

Compare with similar skills

Documentation Maintenance 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.

Documentation Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Documentation Maintenance this skillbradygaster/squad3.3k—~425Automated safety check: PassMIT
Nemoclaw Maintainer Validate LaunchableNVIDIA/NemoClaw23k—~3.1kAutomated safety check: PassApache-2.0
Form Validationthedaviddias/Front-End-Checklist74k—~633Automated safety check: PassMIT
Wiki Maintaineropenclaw/openclaw392k1 repos~462Automated safety check: PassMIT
Open Source Maintainer Assistantslopus/happy24k—~1.9kAutomated safety check: PassMIT
Internal Linksthedaviddias/Front-End-Checklist74k—~770Automated safety check: PassMIT

Similar skills

  • Validate the staging NemoClaw Brev Launchable through its web journey or a deployed environment.

    23k GitHub stars~3.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Form Validation

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Validate forms accessibly.

    74k GitHub stars~633 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Wiki Maintainer

    openclaw/openclaw

    Maintain the OpenClaw memory wiki vault with deterministic pages, managed blocks, and source-backed updates.

    392k GitHub starsUsed in 1 repo~462 tokens
    Knowledge ManagementAuto-check passed
  • Helps maintain the slopus/happy open source project by triaging issues, drafting closing comments, finding duplicates and checking fixes, with approval before anything is posted.

    24k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Internal Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities between related content, or…

    74k GitHub stars~770 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Asset Inventory

    sickn33/agentic-awesome-skills

    Maintain IT asset inventory and configuration management database.

    47k GitHub starsUsed in 2 repos~3.4k tokens
    Auto-check passed

More from bradygaster/squad

All 31 skills in this repo
  • Fact Checking

    bradygaster/squad

    Review and validate claims using counter-hypothesis testing.

    3.3k GitHub stars~503 tokensUpdated today
    Auto-check passed
  • Architectural Review

    bradygaster/squad

    How to review PRs for architectural quality — module boundaries, dependency direction, export surface, pattern consistency

    3.3k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Archival Integrity

    bradygaster/squad

    Preserve content when moving entries between tracked Squad state files

    3.3k GitHub stars~735 tokensUpdated today
    Auto-check passed
  • CI Validation Gates

    bradygaster/squad

    Defensive CI/CD patterns: semver validation, token checks, retry logic, and draft detection

    3.3k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • CLI Wiring

    bradygaster/squad

    Checklist and patterns for wiring new CLI commands into cli-entry.ts

    3.3k GitHub stars~501 tokensUpdated today
    Auto-check passed
  • Enables squad agents on different machines to share work via git-based task queuing

    3.3k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Questions about Documentation Maintenance

What does Documentation Maintenance do?

Maintain accurate, scannable Squad documentation with validated inventory and links. Documentation Maintenance is an agent skill from bradygaster/squad.

How do I install Documentation Maintenance in Claude Code?

Run `npx skills add bradygaster/squad --skill documentation-maintenance -a claude-code`. Or copy the skill folder (.copilot/skills/documentation-maintenance in bradygaster/squad) into .claude/skills/documentation-maintenance in your project. Claude Code loads it when a task matches its description.

How do I install Documentation Maintenance in Codex?

Run `npx skills add bradygaster/squad --skill documentation-maintenance -a codex`. Or copy the skill folder (.copilot/skills/documentation-maintenance in bradygaster/squad) into .agents/skills/documentation-maintenance in your project. Codex loads it when a task matches its description.

Can I use Documentation Maintenance 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 bradygaster/squad --skill documentation-maintenance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/documentation-maintenance, .gemini/skills/documentation-maintenance, .github/skills/documentation-maintenance and .opencode/skills/documentation-maintenance in your project.

What does Documentation Maintenance need to run?

SKILL.md names no scripts, command-line tools or credentials: Documentation Maintenance is instructions for the agent only.

Does Documentation Maintenance 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 Documentation Maintenance 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 Documentation Maintenance use?

Documentation Maintenance 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 Documentation Maintenance use?

About 425 tokens (SKILL.md is roughly 1.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 Documentation Maintenance?

Skills that share tags, products or a category with Documentation Maintenance: Nemoclaw Maintainer Validate Launchable (NVIDIA/NemoClaw, 23k stars), Form Validation (thedaviddias/Front-End-Checklist, 74k stars), Wiki Maintainer (openclaw/openclaw, 392k stars) and Open Source Maintainer Assistant (slopus/happy, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Documentation Maintenance?

bradygaster (a GitHub user) maintains it in bradygaster/squad, which has 3,257 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 8, 2026.

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