Skip to content

Uses the project-discipline-guides SKILL to remove "common" knowledge from discipline guides#808

Open
micahjo7 wants to merge 1 commit into
mainfrom
discipline-guides-cutdown
Open

Uses the project-discipline-guides SKILL to remove "common" knowledge from discipline guides#808
micahjo7 wants to merge 1 commit into
mainfrom
discipline-guides-cutdown

Conversation

@micahjo7

@micahjo7 micahjo7 commented May 14, 2026

Copy link
Copy Markdown
Collaborator

The SKILL was developed in #748.

  1. First it pulls content generated from Claude Code, Gemini CLI, Codex CLI regarding a "discipline".
  2. It combines the common information from each of the three into one mirror.md file.
  3. This mirror.md file content is compared with the discipline guide (e.g. guides/accessibility/accessibility/guide.md)
  4. The content from the guide that is already in the mirror is removed from the guide.

This way we ensure that the guides do not contain information that (most) coding agents already have know.

This PR shows the results of running this SKILL on all the discipline guides that we have checked in currently.
Note that the webmcp guide did not have any changes (no common knowledge found).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As discussed offline, I'm uncomfortable to wholesale remove content from these guides without more data first

@paulirish paulirish added P0 and removed P0 labels May 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants