agentleFS
Sign inStart free
sreejithramansreejithraman/SreeStack/skills/code-quality/SKILL.md

code-quality

Skill1 starsChanged 16 days agoMITView on GitHub

Run Crapper, Dryer, and Mutator for complexity, duplication, and mutation-test reports on Clojure, Java, Go, TypeScript, Rust, or Python. Crapper and Mutator also support JavaScript.

77 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use spring-boot, logging-patterns and 9 more.

Other files people use alongside this one.

Files 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.
  • ffsshhttiikkSkill

    spring-boot

    Spring Boot framework and Java enterprise patterns

    Also in 3 projects that use this

  • DIL8654Skill

    logging-patterns

    Keep logs structured, correlated, low-noise, and safe for production support. Use when adding operational logging, reviewing observability, or improving diagnostics in .NET services.

    Also in 3 projects that use this

  • mstuder-slalomSkill

    jpa-patterns

    JPA/Hibernate patterns for entity design, relationships, query optimization, transactions, auditing, indexing, pagination, and pooling in Spring Boot.

    Also in 3 projects that use this

  • ffsshhttiikkSkill

    design-patterns

    Practical application and coding skills for Design Patterns

    Also in 4 projects that use this

  • glommerSkill

    pr-workflow

    General guidelines for Commits, formatting, CI, dependencies, security

    Also in 4 projects that use this

  • vm0-aiSkill

    cli-design

    Design patterns and conventions for the Okou CLI user experience

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 4 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 71 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run the tools and report their output.

    line 8
  2. Distinctive:

    Run from the target project's root.

    line 11
  3. Distinctive:

    Check language support for each selected tool and report unsupported inputs as skipped.

    line 13
  4. Very specific:

    Use uvx to run the pinned upstream tools.

    line 16
  5. Distinctive:

    Run the selected commands below, appending requested file or directory paths and tool flags.

    line 19
  6. Very specific:

    Use each tool's --help for options.

    line 32
  7. Very specific:

    When fresh mutation results are needed after tests or dependencies change, use Mutator's --mutate-all to avoid reusing cached kills for …

    line 42

“Common” is measured: kept by at least 6 in 10 of the 71 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Code Quality

Run the tools and report their output. Leave source changes and acceptance policy to the caller.

Run from the target project's root. Run all three tools unless a subset is requested. Honor requested paths and flags; without paths, analyze the project. Check language support for each selected tool and report unsupported inputs as skipped.

Use uvx to run the pinned upstream tools. Follow the setup if uvx is unavailable.

Run the selected commands below, appending requested file or directory paths and tool flags.

crapper_source="git+https://github.com/unclebob/crapper.git@6fd92c4c9bcc56efb64a2f8743d5a2993bcfd42d"
dryer_source="git+https://github.com/unclebob/dryer.git@66ff6d21a42c04afcad89c78a80066176d1294b0"
mutator_source="git+https://github.com/unclebob/mutator.git@a5a0cb803b66e0cdb8bf471b3b08af701d424a41"

uvx --from "$crapper_source" crapper
uvx --from "$dryer_source" dryer
uvx --from "$mutator_source" --with "crapper @ $crapper_source" mutator

Use each tool's --help for options. Supply the project's test or coverage command when its defaults do not fit. --changed selects uncommitted Git changes; for a branch comparison, resolve the changed paths against the requested base and pass those paths explicitly.

Return the commands, analyzed scope, exit statuses, and a concise summary of the output. Include reports written by this run: .metrics/crap.edn, .metrics/dry.edn, and .metrics/mutate/ for the respective tools. Distinguish tool or coverage failures from code findings. Dryer can report duplicates with exit status 0; Mutator uses 3 for survivors and 2 for a failed baseline. When fresh mutation results are needed after tests or dependencies change, use Mutator's --mutate-all to avoid reusing cached kills for unchanged functions.

Command details: Crapper, Dryer, Mutator.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free