New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Docs Update

by JayFarei in JayFarei/opentraces

Synchronize all documentation surfaces after code changes. An agent skill from JayFarei/opentraces.

Custom licenceAuto-check passedDevelopment

Install Docs Update

skills CLI
$ npx skills add JayFarei/opentraces --skill docs-update -a claude-code

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

GitHub CLI
$ gh skill install JayFarei/opentraces docs-update --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/JayFarei/opentraces.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/docs-update .claude/skills/docs-update && 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-update
GitHub stars
100
Token cost
~4.6k tokens
SKILL.md length
1,642 words
Files
2 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

Synchronize all documentation surfaces after code changes. An agent skill from JayFarei/opentraces.

  • Works in 4 steps: Detect what changed → Parallel update agents → Adversarial review → …
  • The user says docs-update
  • SKILL.md covers Why this exists, How to run, Phase 1: Detect what changed and Phase 2: Parallel update agents, plus 3 more sections
  • Calls git, pipx and bash

What it does

Docs Update is an agent skill from JayFarei/opentraces. Synchronize all documentation surfaces after code changes. Use when the user says "docs-update", "update docs", "sync docs", "update references", "docs are stale", or after any significant code change (CLI commands, schema fields, install methods, new features). This skill catches stale references across 50+ files: marketing site, mkdocs pages, llms.txt, the agent skill, CLI help text, viewer UI, and READMEs. Proactively suggest this after merging features or changing CLI surface.

Its SKILL.md is about 4.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/surface-map.md`).

It sits in Development, covering Technical documentation, Landing pages and AI search optimization. The repository describes itself as: A local-first evidence layer for agent work, capturing what the agent sees, does, and changes.

When your agent uses it

  • The user says docs-update
  • Update references
  • After any significant code change (CLI commands
  • Install methods

Example prompts

  • “docs-update”
  • “update docs”
  • “sync docs”
  • “/docs-update”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Detect what changed
  2. Parallel update agents
  3. Adversarial review
  4. Apply and report

What it can do on your machine

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

    • git
    • pipx
    • bash
    • brew
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use git, pipx and pip, 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 Update loads about 4.6k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 124 tokens; SKILL.md has 1,642 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~124
When it runs · the whole SKILL.md, loaded when a task matches
~4.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.6k

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 1,642 words (~4,604 tokens).

“Detect code changes and propagate them across every documentation surface in the project.”

— opening of SKILL.md by JayFarei, Custom licence
name
docs-update

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in .claude/skills/docs-update of JayFarei/opentraces.

  • SKILL.md
  • references/surface-map.md

Open the folder on GitHubat commit 354755d

Compare with similar skills

Docs Update 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 Update compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Update this skillJayFarei/opentraces100—~4.6kAutomated safety check: PassCustom licence
Dashclaw Shipucsandman/DashClaw310—~7.2kAutomated safety check: PassMIT
Beautify GitHub Readmeoil-oil/beautify-github-readme1.8k—~4.1kAutomated safety check: PassMIT
Beautify GitHub ReadmeZergie/YAMMU1061 repos~3.2kAutomated safety check: PassGPL-3.0
Golang Documentationunxed/f42413 repos~3.5kAutomated safety check: PassMIT
Sync Public DocsCaldis/react-zmage946—~3.3kAutomated safety check: PassMIT

Similar skills

  • Dashclaw Ship

    ucsandman/DashClaw

    The single command that gets a DashClaw change ON MAIN AND LIVE — it resolves everything blocking production, never defers, and never hands back a checklist.

    310 GitHub stars~7.2k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

  • Beautify GitHub Readme

    oil-oil/beautify-github-readme

    Redesign GitHub README homepages or create project-native pure SVG, hybrid SVG-composed PNG/WebP, and opt-in animated GIF assets.

    1.8k GitHub stars~4.1k tokensUpdated 4 days ago
    DevelopmentAuto-check passed

  • Beautify GitHub Readme

    Zergie/YAMMU

    Redesign GitHub README homepages or create standalone GitHub-safe SVG and animated GIF assets around a repository's real theme.

    106 GitHub starsUsed in 1 repo~3.2k tokens
    DevelopmentAuto-check passed

  • Golang Documentation

    unxed/f4

    Comprehensive documentation guide for Golang projects, covering godoc comments, README, CONTRIBUTING, CHANGELOG, Go Playground, Example tests, API docs, and llms.txt.

    241 GitHub starsUsed in 3 repos~3.5k tokens
    DevelopmentAuto-check passed

  • Sync Public Docs

    Caldis/react-zmage

    A skill your agent uses when modifying public API in packages/core (types/global.ts, types/default.ts, index.ts, or package.json exports field), adding/renaming/removing props, changing default…

    946 GitHub stars~3.3k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed

  • Auto Improve

    crimeacs/auto-improve

    GAN-style iterative improvement loop for any text artifact. An agent skill from crimeacs/auto-improve.

    135 GitHub stars~651 tokensUpdated 2 mo ago
    EducationAuto-check passed

More from JayFarei/opentraces

All 13 skills in this repo

  • Opentraces Marketing

    JayFarei/opentraces

    Generate branded marketing screenshots of opentraces CLI commands — wordmark + CLI card + caption + wallpaper, filename-stamped and auto-copied to the clipboard.

    100 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed

  • Deploy Site

    JayFarei/opentraces

    Land every site-related fix on main, deploy opentraces.ai to Vercel production, and verify it works across all pages (desktop + mobile) and the email-capture flow, fixing and re-deploying until green.

    100 GitHub stars~4.3k tokensUpdated yesterday
    Auto-check passed

  • Gitsync

    JayFarei/opentraces

    Sync both git repos in this project: opentraces (root) and closedtraces (kb/).

    100 GitHub stars~589 tokensUpdated yesterday
    Auto-check passed

  • New Plan

    JayFarei/opentraces

    Create a new plan document in kb/plans/ for the opentraces project.

    100 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed

  • PR Intent Summary V1

    JayFarei/opentraces

    Per-commit trace lineage rows for a branch context, deterministic.

    100 GitHub stars~534 tokensUpdated yesterday
    Auto-check passed

  • Skill Command Trajectory Eval V1

    JayFarei/opentraces

    Derive compact eval rows from command-attributed trace trajectories.

    100 GitHub stars~681 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Docs Update

What does Docs Update do?

Synchronize all documentation surfaces after code changes. An agent skill from JayFarei/opentraces. Docs Update is an agent skill from JayFarei/opentraces. Synchronize all documentation surfaces after code changes.

When should I use Docs Update?

Docs Update fits situations like: the user says docs-update; update references; after any significant code change (CLI commands; install methods.

How do I install Docs Update in Claude Code?

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

How do I install Docs Update in Codex?

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

Can I use Docs Update 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 JayFarei/opentraces --skill docs-update -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-update, .gemini/skills/docs-update, .github/skills/docs-update and .opencode/skills/docs-update in your project.

What does Docs Update need to run?

Going by SKILL.md and its folder, Docs Update needs the command-line tools its instructions call (git, pipx, bash, brew and pip). Our summary lists: Python 3.

Does Docs Update access the network?

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

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

Docs Update 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 Update use?

About 4.6k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Docs Update?

Skills that share tags, products or a category with Docs Update: Dashclaw Ship (ucsandman/DashClaw, 310 stars), Beautify GitHub Readme (oil-oil/beautify-github-readme, 1.8k stars), Beautify GitHub Readme (Zergie/YAMMU, 106 stars) and Golang Documentation (unxed/f4, 241 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Update?

JayFarei (a GitHub user) maintains it in JayFarei/opentraces, which has 100 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 6, 2026.

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