Agent skill

Coherence Auditor

by GoogleChrome in GoogleChrome/modern-web-guidance-src

Run a document coherence, link integrity, and git repository status audit across repository markdown files using a dedicated subagent.

Apache-2.0Auto-check passedAgent Workflows

Install Coherence Auditor

skills CLI
$ npx skills add GoogleChrome/modern-web-guidance-src --skill coherence-auditor -a claude-code

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

GitHub CLI
$ gh skill install GoogleChrome/modern-web-guidance-src coherence-auditor --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/GoogleChrome/modern-web-guidance-src.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/coherence-auditor .claude/skills/coherence-auditor && 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
coherence-auditor
GitHub stars
1.1k
Token cost
~901 tokens
SKILL.md length
436 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
Apache-2.0

At a glance

Run a document coherence, link integrity, and git repository status audit across repository markdown files using a dedicated subagent.

  • Works in 8 steps: Git State Check: Verifies if the working… → Root Clutter Check: Identifies untracked… → Link Integrity Check: Scans all markdown… → …
  • Documentation changes
  • Calls node
  • Open questions are answered

What it does

Coherence Auditor is an agent skill from GoogleChrome/modern-web-guidance-src. Run a document coherence, link integrity, and git repository status audit across repository markdown files using a dedicated subagent. Use when documentation changes, open questions are answered, or before milestone commits.

Its SKILL.md is about 900 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 Agent Workflows, covering Subagents and Project management. It works with Git. The licence is Apache-2.0.

When your agent uses it

  • Documentation changes
  • Open questions are answered
  • Before milestone commits

Example prompts

  • “/coherence-auditor”

Workflow steps

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

  1. Git State Check: Verifies if the working tree is clean and warns if you are working directly on the main branch.
  2. Root Clutter Check: Identifies untracked or non-canonical markdown files in the root directory that should be cleaned up.
  3. Link Integrity Check: Scans all markdown files (excluding dist/ and node_modules/) and verifies that all relative markdown links point to…
  4. Feature Map Sync Check: Verifies that guides/features-and-use-cases.md is in sync with the actual guides in the repository.
  5. TODO/TBD Scan: Scans canonical docs and source guides for TODO, TBD, FIXME, or other unresolved markers.
  6. Skills Configuration Check: Warns if any skill in skills-src/ is not configured in lib/skills-config.ts.
  7. Coherence between CONTEXT.md and Project Skills: Lists CONTEXT.md and all project-* prefixed skills in .agents/skills/ to prompt a…
  8. Guides Integrity Check: Runs the automated test suite guides/guides-integrity.test.ts to validate guide frontmatter, markdown soundness…

What it can do on your machine

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

    • node

    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

Coherence Auditor loads about 901 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 436 words of instructions outside code blocks.

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

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 GoogleChrome/modern-web-guidance-src at commit c312847, republished under its Apache-2.0 licence (© GoogleChrome). 436 words, ~901 tokens.

Download SKILL.mdSave it as .claude/skills/coherence-auditor/SKILL.md (or your agent's skills folder).
name
coherence-auditor
description
Run a document coherence, link integrity, and git repository status audit across repository markdown files using a dedicated subagent. Use when documentation changes, open questions are answered, or before milestone commits.

Document Coherence & Repository Auditor Skill

This skill allows you to run a comprehensive audit of the repository's documentation coherence, link integrity, and git status. It is designed to be run on-demand to catch broken links, out-of-sync mappings, untracked clutter, and unresolved TODOs.

Workflow Instructions

  1. Spawn the document-coherence-auditor Subagent: Define and invoke the subagent using define_subagent and invoke_subagent.
Subagent Definition:
  • Name: document-coherence-auditor

  • Description: Audits documentation coherence, link integrity, and git working-tree health.

  • System Prompt: You are a meticulous Document Coherence, Quality, and Git Repository Auditor subagent for this project.

    When invoked, you will run the audit script to check the state of the workspace and documentation.

    You should run the following command to execute the audit:

    bash
    node --experimental-strip-types scripts/coherence-audit.ts

    This script performs the following checks:

    1. Git State Check: Verifies if the working tree is clean and warns if you are working directly on the main branch.
    2. Root Clutter Check: Identifies untracked or non-canonical markdown files in the root directory that should be cleaned up.
    3. Link Integrity Check: Scans all markdown files (excluding dist/ and node_modules/) and verifies that all relative markdown links point to existing files.
    4. Feature Map Sync Check: Verifies that guides/features-and-use-cases.md is in sync with the actual guides in the repository.
    5. TODO/TBD Scan: Scans canonical docs and source guides for TODO, TBD, FIXME, or other unresolved markers.
    6. Skills Configuration Check: Warns if any skill in skills-src/ is not configured in lib/skills-config.ts.
    7. Coherence between CONTEXT.md and Project Skills: Lists CONTEXT.md and all project-* prefixed skills in .agents/skills/ to prompt a semantic coherence check.
    8. Guides Integrity Check: Runs the automated test suite guides/guides-integrity.test.ts to validate guide frontmatter, markdown soundness, and macro usage.

    To run a full preflight check (build, typecheck, lint, and all tests), you can run:

    bash
    node --experimental-strip-types scripts/coherence-audit.ts --preflight

    Your instructions:

    1. Run the audit script.
    2. Capture and analyze the output.
    3. Perform a semantic coherence check: Read CONTEXT.md and all project-* prefixed skills in .agents/skills/ and verify that the workflow stages, checkpoints, roles, and technical requirements described are consistent and do not contradict each other.
    4. Report all findings, warnings, and errors in a structured format in your final report.
    5. If there are broken links, identify the file and line, and suggest the fix.
    6. If features-and-use-cases.md is out of sync, report it.
    7. Report any semantic inconsistencies or terminology drift between CONTEXT.md and the project skills.
    8. Do NOT make any modifications to the repository files yourself; this is a read-only audit.
Show full SKILL.md (27 more words)Show less
  1. Process Subagent Audit Output:
    • Review the findings reported by the subagent.
    • Fix any broken links or out-of-sync files reported.
    • Address any warnings before finalizing your work.

© GoogleChrome, Apache-2.0. 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 .agents/skills/coherence-auditor of GoogleChrome/modern-web-guidance-src.

Open the folder on GitHubat commit c312847

Compare with similar skills

Coherence Auditor 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.

Coherence Auditor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Coherence Auditor this skillGoogleChrome/modern-web-guidance-src1.1k—~901Automated safety check: PassApache-2.0
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Gh Issuestrpc-group/trpc-agent-go1.8k8 repos~8.7kAutomated safety check: PassApache-2.0
PmApra-Labs/apra-fleet101—~5.4kAutomated safety check: PassCustom licence
Agent RelayAgentWorkforce/relay865—~1.7kAutomated safety check: PassApache-2.0
Badstephenleo/bmad-autonomous-development107—~7.7kAutomated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Gh Issues

    trpc-group/trpc-agent-go

    Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments.

    1.8k GitHub starsUsed in 8 repos~8.7k tokens
    Agent WorkflowsAuto-check passed
  • Pm

    Apra-Labs/apra-fleet

    Project Manager skill. An agent skill from Apra-Labs/apra-fleet.

    101 GitHub stars~5.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent Relay

    AgentWorkforce/relay

    A skill your agent uses when you need Codex to coordinate multiple agents through Agent Relay for peer-to-peer messaging, lead/worker handoffs, or shared status tracking across sub-agents and…

    865 GitHub stars~1.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Bad

    stephenleo/bmad-autonomous-development

    BMad Autonomous Development — orchestrates parallel story implementation pipelines.

    107 GitHub stars~7.7k tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed
  • Review

    fossasia/eventyay-interpretation

    Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match…

    1.6k GitHub starsUsed in 34 repos~996 tokens
    Product & Project ManagementAuto-check passed

More from GoogleChrome/modern-web-guidance-src

All 14 skills in this repo
  • Nightly Eval Investigation

    GoogleChrome/modern-web-guidance-src

    Downloads and analyzes the latest three distinct nightly evaluation runs (Claude Code, Codex CLI, and Jetski CLI) from the GCS remote dashboard to identify and flag unhealthy or low-performing tasks…

    1.1k GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Chrome Extensions

    GoogleChrome/modern-web-guidance-src

    Build and publish Chrome Extensions using Manifest V3 best practices.

    1.1k GitHub stars~6.6k tokensUpdated today
    Auto-check: notes
  • Privacy

    GoogleChrome/modern-web-guidance-src

    Action-oriented guidelines for privacy by design, data minimization, third-party audits, and modern browser privacy APIs.

    1.1k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Project Coding Standards

    GoogleChrome/modern-web-guidance-src

    Coding style, architectural conventions, and PR review standards for the modern-web-guidance-src (guidance) repository.

    1.1k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Project Discipline Guides

    GoogleChrome/modern-web-guidance-src

    Workflow for refactoring discipline-level guides (e.g., JavaScript, CSS) to remove "Common Knowledge" by generating and comparing against model-specific "Knowledge Mirrors".

    1.1k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Project Evals

    GoogleChrome/modern-web-guidance-src

    Best practices for creating expectations and grader files to evaluate guidance quality.

    1.1k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Works with

Questions about Coherence Auditor

What does Coherence Auditor do?

Run a document coherence, link integrity, and git repository status audit across repository markdown files using a dedicated subagent. Coherence Auditor is an agent skill from GoogleChrome/modern-web-guidance-src. Run a document coherence, link integrity, and git repository status audit across repository markdown files using a dedicated subagent.

When should I use Coherence Auditor?

Coherence Auditor fits situations like: documentation changes; open questions are answered; before milestone commits.

How do I install Coherence Auditor in Claude Code?

Run `npx skills add GoogleChrome/modern-web-guidance-src --skill coherence-auditor -a claude-code`. Or copy the skill folder (.agents/skills/coherence-auditor in GoogleChrome/modern-web-guidance-src) into .claude/skills/coherence-auditor in your project. Claude Code loads it when a task matches its description.

How do I install Coherence Auditor in Codex?

Run `npx skills add GoogleChrome/modern-web-guidance-src --skill coherence-auditor -a codex`. Or copy the skill folder (.agents/skills/coherence-auditor in GoogleChrome/modern-web-guidance-src) into .agents/skills/coherence-auditor in your project. Codex loads it when a task matches its description.

Can I use Coherence Auditor 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 GoogleChrome/modern-web-guidance-src --skill coherence-auditor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/coherence-auditor, .gemini/skills/coherence-auditor, .github/skills/coherence-auditor and .opencode/skills/coherence-auditor in your project.

What does Coherence Auditor need to run?

Going by SKILL.md and its folder, Coherence Auditor needs the command-line tools its instructions call (node).

Does Coherence Auditor 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 Coherence Auditor 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 Coherence Auditor use?

Coherence Auditor is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Coherence Auditor use?

About 901 tokens (SKILL.md is roughly 3.6k 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 Coherence Auditor?

Skills that share tags, products or a category with Coherence Auditor: CCPM Project Management (automazeio/ccpm, 8.4k stars), Gh Issues (trpc-group/trpc-agent-go, 1.8k stars), Pm (Apra-Labs/apra-fleet, 101 stars) and Agent Relay (AgentWorkforce/relay, 865 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Coherence Auditor?

GoogleChrome (a GitHub organization) maintains it in GoogleChrome/modern-web-guidance-src, which has 1,134 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.

Source: GoogleChrome/modern-web-guidance-src on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.