code-comments

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

• 0

  Common

  Most of the 25 edited versions we read keep these.

• 2

  Distinctive

  This author's own choices. Worth a look.

• 1

  Very specific

  Tied to their project's names, files or tools. Probably skip.

Licensed with conditions — read it at the source. We count its rules but don't quote them. Read them on GitHub.

“Common” is measured: kept by at least 6 in 10 of the 25 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

• Other versions28 projects use a version of this.

  Word for word · 0

  None found.

  Edited · 0

  None found.

  Wrote their own version · 28

  1. bholmesdev/hubble.md★ 1.5ksame name
  2. AllayMC/Allay★ 348same name
  3. pensarai/apex★ 322same name
  4. portabletext/editor★ 284same name
  5. petekp/claude-code-setup★ 48same name
  6. keitakn/engineering-skills★ 14same name
  7. caidanw/skills★ 8same name
  8. ARTPARK-SAHAI-ORG/calibrate-backend★ 4same name
  9. karlhorky/agent-skills★ 4same name
  10. ton-anywhere/my-favorite-prompts★ 4same name

  18 more not listed

  How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

• Used alongsideProjects with it also use simplify, api-design and 5 more.

  Other files people use alongside this one.

  How we pick theseFiles found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.

  • Hugging FaceSkill

    simplify

    Refactor code after tests pass. The "Refactor" phase of Red-Green-Refactor.

    Also in 3 projects that use this

  • MicrosoftSkill

    api-design

    Guide for designing and documenting RESTful APIs. Use when asked to design an API, create endpoints, or document an API.

    Also in 3 projects that use this

  • HashiCorpSkill

    changelog

    Add a `.changelog/<PR_NUMBER>.txt` entry for a GitHub Pull Request, commit, and push.

    Also in 3 projects that use this

  • GoogleSkill

    codebase-design

    Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

    Also in 3 projects that use this

  • GoogleSkill

    improve-codebase-architecture

    Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

    Also in 3 projects that use this

  • MicrosoftSkill

    handoff

    Compact the current conversation into a handoff document for another agent to pick up.

    Also in 3 projects that use this

  • +1 more from google
• In this repository11 other files it gives its agents.

  • AGENTS.mdAGENTS.md
  • api-endpointsSkill
  • backend-architectureSkill
  • data-workshopSkill
  • engineering-tasteSkill
  • finetuning-model-onboardingSkill
  • frontend-designSkill
  • mcpSkill
  • pr-etiquetteSkill
  • run-testsSkill
  • seed-demo-dataSkill