Agent skill

Docs Sync

by Kiln-AI in Kiln-AI/Kiln

Find and fix the docs and agent guidance that a branch makes stale - agent skills and their reference files, AGENTS.md and .agents/.md prompts, READMEs, docs/ folders, and code-adjacent docs that…

Custom licenceAuto-check passedAI & LLM Engineering

Install Docs Sync

skills CLI
$ npx skills add Kiln-AI/Kiln --skill docs-sync -a claude-code

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

GitHub CLI
$ gh skill install Kiln-AI/Kiln docs-sync --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/Kiln-AI/Kiln.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-sync .claude/skills/docs-sync && 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-sync
GitHub stars
5.2k
Token cost
~1.7k tokens
SKILL.md length
796 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
Custom licence

At a glance

Find and fix the docs and agent guidance that a branch makes stale - agent skills and their reference files, AGENTS.md and .agents/.md prompts, READMEs, docs/ folders, and code-adjacent docs that…

  • Works in 6 steps: Find what changed → Find the docs that mention them → Update each stale statement in place → …
  • Tasks that involve Technical documentation
  • SKILL.md covers 1. Find what changed, 2. Find the docs that mention…, 3. Update each stale statement… and 4. Do not make these edits, plus 2 more sections
  • Calls git and gh

What it does

Docs Sync is an agent skill from Kiln-AI/Kiln. Find and fix the docs and agent guidance that a branch makes stale - agent skills and their reference files, AGENTS.md and .agents/.md prompts, READMEs, docs/ folders, and code-adjacent docs that name a changed path, command, symbol, env var, setting, endpoint or behaviour. Use before opening a PR, before pushing new commits to an open PR, and when asked to update docs or skills after a change. The open-pr skill runs it every time.

Its SKILL.md is about 1.7k 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 AI & LLM Engineering, covering Technical documentation and Agent instruction files. It works with Python. The repository describes itself as: Build, Evaluate, and Optimize AI Systems. Includes evals, RAG, agents, fine-tuning, synthetic data generation, dataset management, MCP, and more.

When your agent uses it

  • Tasks that involve Technical documentation
  • Tasks that involve Agent instruction files

Example prompts

  • “/docs-sync”

Requirements

  • Python 3

Workflow steps

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

  1. Find what changed
  2. Find the docs that mention them
  3. Update each stale statement in place
  4. Do not make these edits
  5. Commit and report
  6. Done when

What it can do on your machine

Read from SKILL.md and the folder at commit 1348420. 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
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use git and gh, 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 Sync loads about 1.7k tokens when it runs. Until then it costs about 112 tokens; SKILL.md has 796 words of instructions outside code blocks.

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

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 796 words (~1,722 tokens).

“A change that renames a script or removes a function leaves every doc that names it wrong, and the next agent follows the wrong doc. Run this before you open a PR and before each push to an open PR…”

— opening of SKILL.md by Kiln-AI, Custom licence
name
docs-sync

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/docs-sync of Kiln-AI/Kiln.

Open the folder on GitHubat commit 1348420

Compare with similar skills

Docs Sync 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 Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Sync this skillKiln-AI/Kiln5.2k—~1.7kAutomated safety check: PassCustom licence
Sync Docsayutaz/piper-plus220—~1.4kAutomated safety check: PassMIT
Create Simple Promptpnp/copilot-prompts892—~2.6kAutomated safety check: PassMIT
Add Benchmarkai-twinkle/Eval117—~1.8kAutomated safety check: PassMIT
Sft Launchopen-thoughts/OpenThoughts-Agent301—~2.9kAutomated safety check: PassApache-2.0
Adk Sample Creatorgoogle/adk-python22k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Sync Docs

    ayutaz/piper-plus

    コミット前にエージェントチームで全ドキュメント (CLAUDE.md / README / CHANGELOG / docs/) を監査し、コード変更に応じて自動更新します。大規模変更時の documentation drift を予防。

    220 GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Create Simple Prompt

    pnp/copilot-prompts

    This skill should be used when the user asks to "create a new prompt sample", "add a new prompt sample", "scaffold a new prompt sample", "create a prompt contribution", "add a prompt", or needs to…

    892 GitHub stars~2.6k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Add Benchmark

    ai-twinkle/Eval

    為 Twinkle Eval 新增一個評測 benchmark(IFEval、BFCL、RAGAS、Text2SQL、Vision MCQ 之類)。涵蓋 CLAUDE.md §6 的完整強制流程:先建 Milestone 與 6 個 Issue、準備 example dataset、實作 Extractor + Scorer 並註冊 PRESETS、與參考框架做分數與速度對比、撰寫…

    117 GitHub stars~1.8k tokensUpdated 23 days ago
    AI & LLM EngineeringAuto-check passed
  • Sft Launch

    open-thoughts/OpenThoughts-Agent

    Launch SFT via python -m hpc.launch --jobtype sft on any cluster (JSC Jupiter GH200, CINECA Leonardo A100, TACC Vista GH200), with EITHER backend — LLaMA-Factory (default) or axolotl (--sftbackend…

    301 GitHub stars~2.9k tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check passed
  • Adk Sample Creator

    google/adk-python

    Official

    Creates a new sample agent in the ADK Python repository — the sample directory, its agent.py, and its README.md — following the conventions the existing samples already use.

    22k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Document Public APIs

    pytorch/pytorch

    Document undocumented public APIs in PyTorch by removing functions from coverageignorefunctions and coverageignoreclasses in docs/source/conf.py, running Sphinx coverage, and adding the appropriate…

    104k GitHub stars~4.2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from Kiln-AI/Kiln

All 14 skills in this repo
  • Check Kiln's model list for deprecated or sunset models across all providers.

    5.2k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: notes
  • Check Kiln's fine-tunable model list for deprecated or unsupported base models.

    5.2k GitHub stars~1.9k tokensUpdated yesterday
    Auto-check: notes
  • Release Digest

    Kiln-AI/Kiln

    Post a "what's changed since the last release" recap to the release Slack channel for final QA.

    5.2k GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Kiln Conventions

    Kiln-AI/Kiln

    Kiln's code conventions and per-area gotchas, plus a diff gate that enforces the mechanical ones.

    5.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • Playwright

    Kiln-AI/Kiln

    Look at Kiln's UI in a real browser, and run its end-to-end tests.

    5.2k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Open PR

    Kiln-AI/Kiln

    Open a pull request on the Kiln repo for a human to complete.

    5.2k GitHub stars~6.1k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Docs Sync

What does Docs Sync do?

Find and fix the docs and agent guidance that a branch makes stale - agent skills and their reference files, AGENTS.md and .agents/.md prompts, READMEs, docs/ folders, and code-adjacent docs that…. Docs Sync is an agent skill from Kiln-AI/Kiln.md prompts, READMEs, docs/ folders, and code-adjacent docs that name a changed path, command, symbol, env var, setting, endpoint or behaviour.

When should I use Docs Sync?

Docs Sync fits situations like: tasks that involve Technical documentation; tasks that involve Agent instruction files.

How do I install Docs Sync in Claude Code?

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

How do I install Docs Sync in Codex?

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

Can I use Docs Sync 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 Kiln-AI/Kiln --skill docs-sync -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-sync, .gemini/skills/docs-sync, .github/skills/docs-sync and .opencode/skills/docs-sync in your project.

What does Docs Sync need to run?

Going by SKILL.md and its folder, Docs Sync needs the command-line tools its instructions call (git and gh). Our summary lists: Python 3.

Does Docs Sync access the network?

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

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

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

About 1.7k tokens (SKILL.md is roughly 6.9k 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 Sync?

Skills that share tags, products or a category with Docs Sync: Sync Docs (ayutaz/piper-plus, 220 stars), Create Simple Prompt (pnp/copilot-prompts, 892 stars), Add Benchmark (ai-twinkle/Eval, 117 stars) and Sft Launch (open-thoughts/OpenThoughts-Agent, 301 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Sync?

Kiln-AI (a GitHub organization) maintains it in Kiln-AI/Kiln, which has 5,177 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.

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