Agent skill

Project Discipline Guides

by GoogleChrome in 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".

Apache-2.0Auto-check passedDevelopment

Install Project Discipline Guides

skills CLI
$ npx skills add GoogleChrome/modern-web-guidance-src --skill project-discipline-guides -a claude-code

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

GitHub CLI
$ gh skill install GoogleChrome/modern-web-guidance-src project-discipline-guides --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/project-discipline-guides .claude/skills/project-discipline-guides && 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
project-discipline-guides
GitHub stars
1.1k
Token cost
~1.1k tokens
SKILL.md length
543 words
Files
8 (incl. scripts)
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 4 steps: Generate Knowledge Mirrors → Perform the Inverse Filter (Agent Task) → Apply Surgical Edits → …
  • Tasks that involve Refactoring
  • SKILL.md covers Workflow: The Inverse… and Core Principles
  • Runs TypeScript scripts from its folder; calls node

What it does

Project Discipline Guides is an agent skill from 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".

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts (for example `intersection_prompt.md`, `mirror_prompt.md` and `mirrors/javascript/claude_mirror.md`).

It sits in Development, covering Refactoring. It works with JavaScript. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Refactoring

Example prompts

  • “Common Knowledge”
  • “Knowledge Mirrors”
  • “/project-discipline-guides”

Requirements

  • Node.js

Workflow steps

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

  1. Generate Knowledge Mirrors
  2. Perform the Inverse Filter (Agent Task)
  3. Apply Surgical Edits
  4. Verification Step

What it can do on your machine

Read from SKILL.md and the folder at commit 0d002f0. 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 1 file in scripts/ (TypeScript), which the agent can run.

    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

Project Discipline Guides loads about 1.1k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 543 words of instructions outside code blocks.

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

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 GoogleChrome/modern-web-guidance-src at commit 0d002f0, republished under its Apache-2.0 licence (© GoogleChrome). 543 words, ~1,129 tokens.

Download SKILL.mdSave it as .claude/skills/project-discipline-guides/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
project-discipline-guides
description
Workflow for refactoring discipline-level guides (e.g., JavaScript, CSS) to remove "Common Knowledge" by generating and comparing against model-specific "Knowledge Mirrors".

Project Discipline Guides

This skill facilitates the "Differential Knowledge Refactor" of technical guides. It ensures that SKILL.md files for specific disciplines are lean, context-efficient, and strictly additive to what modern AI models already know natively.

Workflow: The Inverse Knowledge Filter

The goal is to aggressively "whittle down" a target guide (the Target) by removing any content that is natively understood by modern coding models.

1. Generate Knowledge Mirrors

Use the provided script to generate "Redundancy Mirrors"—comprehensive guides of what Gemini, Claude, and Codex consider "Common Knowledge" for a given discipline, and intersect them into a single LCD mirror.

bash
# Ensure that model setup is configured (instructions are in the top level readme)
node .agents/skills/project-discipline-guides/scripts/generate_mirrors.ts <discipline_name>

This will create files inside the .agents/skills/project-discipline-guides/mirrors/ directory:

  • mirrors/<discipline>/gemini_mirror.md (via Gemini - temporary)
  • mirrors/<discipline>/claude_mirror.md (via Claude - temporary)
  • mirrors/<discipline>/codex_mirror.md (via Codex - temporary)
  • mirrors/<discipline>/mirror.md (Unified Redundancy Mirror intersection)

[!IMPORTANT] Ensure that the unified Redundancy Mirror (.agents/skills/project-discipline-guides/mirrors/<discipline>/mirror.md) has been successfully generated. This mirror represents the exact mathematical intersection of all three source models, preventing pruning errors and reducing context window overhead.

2. Perform the Inverse Filter (Agent Task)

As the agent, read the Target guide and the unified Redundancy Mirror (.agents/skills/project-discipline-guides/mirrors/<discipline>/mirror.md).

  • Strict A - B Comparison: Compare rules in the Target guide strictly against the unified Redundancy Mirror. You should ONLY remove a rule or pattern from the Target guide if it is fully and clearly covered in the Redundancy Mirror.
  • No Subjective Self-Attestation: Rely exclusively on the literal content present in the Redundancy Mirror. Do not prune rules based on your own subjective self-attestation of what you "know" or would do by default. If a concept is not in the Redundancy Mirror, it remains in the Target guide.
  • Avoid Blind Bullet-Point Deletions: If a single bullet point or rule in the Target contains multiple guidelines or APIs, do not delete the entire bullet point just because some parts of it are common knowledge. Carefully split or dissect the rule, pruning only the redundant parts and explicitly retaining any differential knowledge.
  • Preserve Differential Knowledge: Keep only what is unique to this project or necessary to guide the AI effectively. This generally includes:
    • Rules that counter common AI biases.
    • Conventions chosen among valid alternatives.
    • Advanced performance patterns, security constraints, or heuristics that models know but often omit in default outputs.

[!WARNING] Keep the Refactor Scoped: The primary and sole goal of this skill is reduction of redundant common knowledge. Do not add new rules, modify logic, or introduce unrelated guidelines in this refactoring pass. Keep the changes highly focused and easy to review.

Show full SKILL.md (138 more words)Show less
3. Apply Surgical Edits

Perform the cleanup on the Target file. Aim for surgical edits that preserve the file's structure while removing unnecessary content.

In your response, provide an explanation of the changes made and the rationale for what was removed or kept.

4. Verification Step

After applying edits, perform a self-verification:

  • Contrast Check: Verify that none of the rules in the new guide are present in the Redundancy Mirror.
  • Preservation Check: Ensure that critical project-specific rules, behavioral steering, and any specific advanced APIs (such as Object.groupBy()) were not accidentally removed.

Core Principles

  • Delete Redundancies: If a model natively "knows" a rule, it does not belong in the skill.
  • Preserve Signal: Keep instructions that force the model into "Senior Engineer" mode or align with specific project architecture.
  • Context Efficiency: A lean skill is a fast and cheap skill.

© 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

SKILL.md and 7 other files (scripts) in .agents/skills/project-discipline-guides of GoogleChrome/modern-web-guidance-src.

  • SKILL.md
  • intersection_prompt.md
  • mirror_prompt.md
  • mirrors/javascript/claude_mirror.md
  • mirrors/javascript/codex_mirror.md
  • mirrors/javascript/gemini_mirror.md
  • mirrors/javascript/mirror.md
  • scripts/generate_mirrors.ts

Open the folder on GitHubat commit 0d002f0

Compare with similar skills

Project Discipline Guides 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.

Project Discipline Guides compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Discipline Guides this skillGoogleChrome/modern-web-guidance-src1.1k—~1.1kAutomated safety check: PassApache-2.0
Dinero Best Practicesdinerojs/dinero.js6.8k—~756Automated safety check: PassMIT
ast-grep Codemod Referencewarp-drive-data/warp-drive3.2k—~2.6kAutomated safety check: PassMIT
React Best Practicesshapeshift/web2061 repos~2kAutomated safety check: PassMIT
DRY Refactoring With jscpdkucherenko/jscpd6.4k—~2.1kAutomated safety check: PassMIT
Coding Agentmastra-ai/mastra29k—~2.3kAutomated safety check: PassCustom licence

Similar skills

  • Dinero Best Practices

    dinerojs/dinero.js

    Core best practices for the Dinero.js money library. An agent skill from dinerojs/dinero.js.

    6.8k GitHub stars~756 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • ast-grep Codemod Reference

    warp-drive-data/warp-drive

    Reference for writing and debugging TypeScript and JavaScript codemods with @ast-grep/napi: parsing, node queries, meta-variables, rule objects and editing.

    3.2k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • React Best Practices

    shapeshift/web

    Comprehensive React and Next.js performance optimization guide with 40+ rules for eliminating waterfalls, optimizing bundles, and improving rendering.

    206 GitHub starsUsed in 1 repo~2k tokens
    DevelopmentAuto-check passed
  • Removes copy-paste duplication found by jscpd, starting with exact clones and hotspots, then renamed and near-miss copies, using proven refactoring strategies.

    6.4k GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Coding Agent

    mastra-ai/mastra

    Authoring playbook for building agents that write, edit, review, or refactor code.

    29k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Covers ES6+ syntax and functional patterns for refactoring older JavaScript: async/await, destructuring, spread, modules, generators and data pipelines.

    40k GitHub starsUsed in 12 repos~548 tokens
    DevelopmentAuto-check passed

More from GoogleChrome/modern-web-guidance-src

All 12 skills in this repo
  • Coherence Auditor

    GoogleChrome/modern-web-guidance-src

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

    1.1k GitHub stars~864 tokensUpdated today
    Auto-check passed
  • 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.2k 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
  • 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~1.9k 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
  • Project Guides

    GoogleChrome/modern-web-guidance-src

    Best practices for authoring guidance. An agent skill from GoogleChrome/modern-web-guidance-src.

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

Works with

Categories

Questions about Project Discipline Guides

What does Project Discipline Guides do?

Workflow for refactoring discipline-level guides (e.g., JavaScript, CSS) to remove "Common Knowledge" by generating and comparing against model-specific "Knowledge Mirrors". Project Discipline Guides is an agent skill from GoogleChrome/modern-web-guidance-src., JavaScript, CSS) to remove "Common Knowledge" by generating and comparing against model-specific "Knowledge Mirrors".

When should I use Project Discipline Guides?

Project Discipline Guides fits situations like: tasks that involve Refactoring.

How do I install Project Discipline Guides in Claude Code?

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

How do I install Project Discipline Guides in Codex?

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

Can I use Project Discipline Guides 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 project-discipline-guides -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-discipline-guides, .gemini/skills/project-discipline-guides, .github/skills/project-discipline-guides and .opencode/skills/project-discipline-guides in your project.

What does Project Discipline Guides need to run?

Going by SKILL.md and its folder, Project Discipline Guides needs TypeScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.

Does Project Discipline Guides 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 Project Discipline Guides 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 Project Discipline Guides use?

Project Discipline Guides 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 Project Discipline Guides use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Project Discipline Guides?

Skills that share tags, products or a category with Project Discipline Guides: Dinero Best Practices (dinerojs/dinero.js, 6.8k stars), ast-grep Codemod Reference (warp-drive-data/warp-drive, 3.2k stars), React Best Practices (shapeshift/web, 206 stars) and DRY Refactoring With jscpd (kucherenko/jscpd, 6.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Discipline Guides?

GoogleChrome (a GitHub organization) maintains it in GoogleChrome/modern-web-guidance-src, which has 1,143 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 10, 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.