Adk Sample Creator
google/adk-python
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.
Detect documentation drift against code changes, score staleness, validate API docs via AST parsing, and audit link integrity.
Install Doc Drift Detector
$ npx skills add borghei/Claude-Skills --skill doc-drift-detector -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install borghei/Claude-Skills doc-drift-detector --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/doc-drift-detector .claude/skills/doc-drift-detector && rm -rf skills-srcUse ~/.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/
Install the "doc-drift-detector" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/doc-drift-detector into .claude/skills/doc-drift-detector/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-drift-detector", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/borghei/Claude-Skills/tree/main/engineering/doc-drift-detectorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add borghei/Claude-Skills --skill doc-drift-detector -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install borghei/Claude-Skills doc-drift-detector --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/engineering/doc-drift-detector .agents/skills/doc-drift-detector && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "doc-drift-detector" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/doc-drift-detector into .agents/skills/doc-drift-detector/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-drift-detector", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill doc-drift-detector -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install borghei/Claude-Skills doc-drift-detector --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/engineering/doc-drift-detector .cursor/skills/doc-drift-detector && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "doc-drift-detector" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/doc-drift-detector into .cursor/skills/doc-drift-detector/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-drift-detector", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/borghei/Claude-Skills.git --path engineering/doc-drift-detector--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add borghei/Claude-Skills --skill doc-drift-detector -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install borghei/Claude-Skills doc-drift-detector --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/engineering/doc-drift-detector .gemini/skills/doc-drift-detector && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "doc-drift-detector" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/doc-drift-detector into .gemini/skills/doc-drift-detector/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-drift-detector", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install borghei/Claude-Skills doc-drift-detectorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add borghei/Claude-Skills --skill doc-drift-detector -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/engineering/doc-drift-detector .github/skills/doc-drift-detector && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "doc-drift-detector" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/doc-drift-detector into .github/skills/doc-drift-detector/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-drift-detector", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill doc-drift-detector -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install borghei/Claude-Skills doc-drift-detector --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/engineering/doc-drift-detector .opencode/skills/doc-drift-detector && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "doc-drift-detector" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/doc-drift-detector into .opencode/skills/doc-drift-detector/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doc-drift-detector", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
doc-drift-detector- GitHub stars
- 874
- Token cost
- ~1.9k tokens
- SKILL.md length
- 768 words
- Files
- 11 (incl. scripts, references, assets)
- Skills in repo
- 364
- Repo updated
- First seen
- Licence
- MIT
At a glance
Detect documentation drift against code changes, score staleness, validate API docs via AST parsing, and audit link integrity.
- Docs fall out of sync with code
- SKILL.md covers Core Capabilities, When to Use, Clarify First and Tools, plus 4 more sections
- Runs Python scripts from its folder; calls python
- Preparing releases
What it does
Doc Drift Detector is an agent skill from borghei/Claude-Skills. Detect documentation drift against code changes, score staleness, validate API docs via AST parsing, and audit link integrity. Use when docs fall out of sync with code, preparing releases, running CI doc gates, or auditing doc accuracy.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts, reference files and assets (for example `assets/drift_report_template.md`, `assets/sample_drift_data.json` and `references/documentation_standards.md`).
It sits in Development, covering Technical documentation. It works with Python. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.
When your agent uses it
- Docs fall out of sync with code
- Preparing releases
- Running CI doc gates
- Auditing doc accuracy
Example prompts
- “/doc-drift-detector”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit c9a1487. 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
Ships 4 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python
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
Doc Drift Detector loads about 1.9k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 768 words of instructions outside code blocks.
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); the scripts in this folder are not scanned.
SKILL.md
The full file from borghei/Claude-Skills at commit c9a1487, republished under its MIT licence (© borghei). 768 words, ~1,877 tokens.
Download SKILL.mdSave it as
.claude/skills/doc-drift-detector/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.- name
- doc-drift-detector
- description
- Detect documentation drift against code changes, score staleness, validate API docs via AST parsing, and audit link integrity. Use when docs fall out of sync with code, preparing releases, running CI doc gates, or auditing doc accuracy.
- license
- MIT + Commons Clause
- metadata.version
- 2.1.0
- metadata.author
- borghei
- metadata.category
- engineering
- metadata.domain
- documentation
- metadata.updated
- 2026-06-17
- metadata.tags
- documentation, staleness, api-docs, drift-analysis
- metadata.python-tools
- drift_analyzer.py, doc_staleness_scorer.py, api_doc_validator.py, link_checker.py
- metadata.tech-stack
- python, git, markdown, documentation
Documentation Drift Detector
The agent detects documentation drift by mapping code directories to their docs, comparing git modification histories, extracting Python function signatures via AST, validating every markdown link and anchor, and scoring freshness on a weighted 0-100 scale. All four CLI tools use the Python standard library only.
Core Capabilities
- Full drift analysis — map docs to code, compare git histories, detect renamed files, version drift, broken references, and structural gaps; classify each issue by category, severity, and fix type.
- API doc validation — AST-based extraction of Python signatures/classes compared against markdown API docs (undocumented items, phantom docs, parameter mismatches, deprecations).
- Staleness scoring — weighted 0-100 freshness score across five dimensions with CI threshold gates and README-focused mode.
- Link integrity audit — validate local files, anchors, cross-document anchors, images, case-sensitivity, and duplicate anchors; optional external URL checks.
- Drift classification — structural, factual, referential, temporal, semantic categories, each tagged
[AUTO]/[SEMI]/[MANUAL]for fix routing. - CI/CD integration — non-zero exit codes, JSON output, GitHub Actions and pre-commit recipes for ongoing monitoring.
When to Use
- Docs have fallen out of sync with code — run full drift analysis.
- Preparing a release — gate on aggregate staleness score.
- Running CI doc gates — fail PRs on high/critical drift or broken links.
- Auditing API doc accuracy against Python source.
- Checking README health and link integrity after refactors.
Clarify First
Before running detection, confirm these inputs. If any is unknown or vague, ASK — do not assume:
- Which check — full drift analysis, staleness score, API doc validation, or link audit (selects
drift_analyzer.pyvsdoc_staleness_scorer.pyvsapi_doc_validator.pyvslink_checker.py) - Repo & doc/source paths — the repository and which code and docs directories to compare (the input the tools scan)
- Threshold & gate — minimum severity or staleness threshold for CI failure (sets
--min-severity/--thresholdand the exit-code gate)
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Tools
| Tool | Purpose | Command |
|---|---|---|
drift_analyzer.py | Full drift analysis between code and docs | python scripts/drift_analyzer.py <repo> --min-severity high --json |
doc_staleness_scorer.py | Score documentation freshness 0-100 | python scripts/doc_staleness_scorer.py <repo> --threshold 60 |
api_doc_validator.py | Validate API docs against Python source (AST) | python scripts/api_doc_validator.py <src> <docs> --recursive |
link_checker.py | Audit all markdown links and anchors | python scripts/link_checker.py <repo> --broken-only |
All tools: Python 3.8+ stdlib only, --json and --help, non-zero exit codes for CI, any OS.
References
Load the reference that matches the task — keep this file lean and pull detail on demand:
- references/workflows-and-tool-reference.md — quick start, the 5 core workflows (full analysis, API validation, README health, link audit, CI monitoring) with output examples, GitHub Actions + pre-commit recipes, and the complete per-tool parameter/output/exit-code reference. Read when running tools or wiring CI.
- references/scoring-categories-and-troubleshooting.md — the staleness scoring model and weights, the five drift categories, auto-fix vs manual-fix classification, detailed integration points, anti-patterns, troubleshooting table, and success criteria. Read when interpreting results or triaging drift.
- references/documentation_standards.md — README structure, API docs, changelogs, ADRs, docs-as-code standards.
- references/drift_prevention_guide.md — coupling strategies, CI gates, review checklists, and prevention patterns.
Show full SKILL.md (281 more words)Show less
Assets
| Asset | Description |
|---|---|
| Drift Report Template | Template for drift analysis reports |
| Sample Drift Data | Sample JSON for testing and demonstration |
Scope & Limitations
Covers:
- Detection of documentation drift against git history for any git repository
- AST-based validation of Python API documentation (function signatures, class definitions, parameters, return types)
- Internal link validation including local files, markdown anchors, cross-document anchors, images, and case-sensitivity checks
- Multi-dimensional staleness scoring with configurable weights and CI/CD threshold enforcement
Does NOT cover:
- Non-Python source code API validation -- the AST-based validator only parses Python; for TypeScript, Go, Rust, or Java APIs, use language-specific doc generators and pair with the link checker
- External URL uptime monitoring --
--check-externalperforms one-shot HEAD requests but does not provide continuous monitoring; use the senior-devops skill for uptime dashboards - Automatic documentation rewriting -- tools classify issues as
[AUTO],[SEMI], or[MANUAL]but do not generate replacement text; use the code-reviewer skill for AI-assisted doc suggestions - Content quality or readability assessment -- staleness scoring measures freshness and structural completeness, not prose quality; see the standards/communication library for writing guidelines
Integration Points
| Skill | Integration | Data Flow |
|---|---|---|
| code-reviewer | Include drift report in PR review comments | drift_analyzer.py --json output feeds into review checklists as a documentation health section |
| senior-devops | Add staleness gate to CI/CD pipelines | doc_staleness_scorer.py --threshold 50 returns exit code 1 on failure, blocking deploys |
| senior-qa | Documentation quality as part of QA acceptance | link_checker.py --json output merges into QA dashboards alongside test coverage metrics |
| senior-fullstack | Validate generated project docs post-scaffold | Run api_doc_validator.py against scaffolded docs/ directory to confirm generated API docs match source |
| senior-secops | Audit security documentation currency | drift_analyzer.py --scope security/ detects when security docs fall behind policy changes |
| senior-architect | Architecture decision record (ADR) freshness | doc_staleness_scorer.py --required-sections "Status,Context,Decision,Consequences" validates ADR completeness |
© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 10 other files (scripts, references, assets) in engineering/doc-drift-detector of borghei/Claude-Skills.
- SKILL.md
- assets/drift_report_template.md
- assets/sample_drift_data.json
- references/documentation_standards.md
- references/drift_prevention_guide.md
- references/scoring-categories-and-troubleshooting.md
- references/workflows-and-tool-reference.md
- scripts/api_doc_validator.py
- scripts/doc_staleness_scorer.py
- scripts/drift_analyzer.py
- scripts/link_checker.py
Open the folder on GitHubat commit c9a1487
Compare with similar skills
Doc Drift Detector 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Doc Drift Detector this skillborghei/Claude-Skills | 874 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Adk Sample Creatorgoogle/adk-python | 22k | — | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Crafting Effective Readmescumbucadev/cinemaempoa | 146 | 5 repos | ~669 | Automated safety check: Pass | GPL-3.0 | |
| Acquire Codebase Knowledgegithub/awesome-copilot | 40k | 1 repos | ~2.3k | Automated safety check: Pass | MIT | |
| Docs Conventionsflet-dev/flet | 17k | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| DDNS Provider DevelopmentNewFuture/DDNS | 4.7k | — | ~558 | Automated safety check: Pass | MIT |
Similar skills
- Official
Crafting Effective Readmes
cumbucadev/cinemaempoa
A skill your agent uses when writing or improving README files.
- Official
Acquire Codebase Knowledge
github/awesome-copilot
Maps an unfamiliar codebase into seven evidence-backed documents in docs/codebase/, using a scan script and templates, for onboarding or architecture write-ups.
Docs Conventions
flet-dev/flet
A skill your agent uses when writing or reviewing Flet documentation, including Python docstrings (Google style, reST roles, admonitions), Markdown docs (cross-references, images, code examples)…
DDNS Provider Development
NewFuture/DDNS
Adds or changes a DNS provider in the DDNS project while keeping its code, schemas, tests and Chinese and English docs consistent.
Mkdocs
jeka-dev/jeka
MkDocs documentation project reference covering CLI commands, mkdocs.yml configuration, Material theme setup, and plugin integration.
More from borghei/Claude-Skills
All 364 skills in this repoAgents In The Team
borghei/Claude-Skills
Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.
AI Content Disclosure
borghei/Claude-Skills
Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.
AI Prototyping
borghei/Claude-Skills
Idea to AI-generated prototype to customer validation to engineering handoff.
Analytics Engineer
borghei/Claude-Skills
Analytics engineering across data modeling, dbt, transformation, and semantic layers.
Ansoff Matrix
borghei/Claude-Skills
Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.
Brainstorm Okrs
borghei/Claude-Skills
OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.
Related
Works with
Categories
Questions about Doc Drift Detector
What does Doc Drift Detector do?
Detect documentation drift against code changes, score staleness, validate API docs via AST parsing, and audit link integrity. Doc Drift Detector is an agent skill from borghei/Claude-Skills. Detect documentation drift against code changes, score staleness, validate API docs via AST parsing, and audit link integrity.
When should I use Doc Drift Detector?
Doc Drift Detector fits situations like: docs fall out of sync with code; preparing releases; running CI doc gates; auditing doc accuracy.
How do I install Doc Drift Detector in Claude Code?
Run `npx skills add borghei/Claude-Skills --skill doc-drift-detector -a claude-code`. Or copy the skill folder (engineering/doc-drift-detector in borghei/Claude-Skills) into .claude/skills/doc-drift-detector in your project. Claude Code loads it when a task matches its description.
How do I install Doc Drift Detector in Codex?
Run `npx skills add borghei/Claude-Skills --skill doc-drift-detector -a codex`. Or copy the skill folder (engineering/doc-drift-detector in borghei/Claude-Skills) into .agents/skills/doc-drift-detector in your project. Codex loads it when a task matches its description.
Can I use Doc Drift Detector 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 borghei/Claude-Skills --skill doc-drift-detector -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/doc-drift-detector, .gemini/skills/doc-drift-detector, .github/skills/doc-drift-detector and .opencode/skills/doc-drift-detector in your project.
What does Doc Drift Detector need to run?
Going by SKILL.md and its folder, Doc Drift Detector needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Doc Drift Detector 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 Doc Drift Detector 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Doc Drift Detector use?
Doc Drift Detector is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Doc Drift Detector use?
About 1.9k tokens (SKILL.md is roughly 7.5k 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 9.2k tokens, read only when the agent opens those files.
What are the alternatives to Doc Drift Detector?
Skills that share tags, products or a category with Doc Drift Detector: Adk Sample Creator (google/adk-python, 22k stars), Crafting Effective Readmes (cumbucadev/cinemaempoa, 146 stars), Acquire Codebase Knowledge (github/awesome-copilot, 40k stars) and Docs Conventions (flet-dev/flet, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Doc Drift Detector?
borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 874 GitHub stars. The repository holds 364 skills in this directory. The repository was last updated on October 7, 2026.
Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.