Just Good Practices Skill

A provider-neutral Agent Skills pack that helps AI agents write good code across programming languages. The core skills contain language-independent implementation, testing, API, refactoring, and review guidance with concrete code examples. Narrow supplements cover language-specific mechanics only.

Install

Install the complete pack:

npx skills add gosuda/JustGoodPractices

Install only the primary skill:

npx skills add gosuda/JustGoodPractices --skill just-good-practices

Included skills:

• just-good-practices: cross-language engineering workflow and examples.
• testing-practices: deterministic tests, test doubles, assertions, and suite design.
• code-health: control flow, naming, data flow, errors, logging, and cleanup.
• api-design: explicit contracts, ownership, dependencies, and domain modeling.
• code-review: focused changes and evidence-backed review feedback.
• zero-slop: strict zero-slop policy for code comments, commit messages, and documentation.
• go-practices: Go APIs, deterministic Go tests, and the gojgp analyzer.
• cpp-practices: C++ ownership, private boundaries, assertions, death tests, and matchers.
• java-practices: Java framework boundaries, presenters, resources, and collaborators.
• shell-practices: small, safe shell orchestration.

Go Linter

gojgp implements automated checks for Go. The module language version is Go 1.25 and go.mod selects the Go 1.27.0 toolchain. With automatic toolchain selection enabled, Go acquires that toolchain when needed.

go install github.com/gosuda/JustGoodPractices/cmd/gojgp@latest
gojgp ./...

Run Go tests and lint together:

gojgp check

Without installing the binary:

go run github.com/gosuda/JustGoodPractices/cmd/gojgp@latest ./...

golangci-lint

The module root registers gojgp through golangci-lint's module plugin API. Build a local custom binary with:

# .custom-gcl.yml
version: v2.13.2
plugins:
  - module: github.com/gosuda/JustGoodPractices
    path: .

# .golangci.yml
version: "2"
linters:
  default: none
  enable:
    - gojgp
  settings:
    custom:
      gojgp:
        type: module
        description: Go engineering practice checks

golangci-lint custom
./custom-gcl run ./...

Develop

go test ./...
go run ./cmd/gojgp ./...

License

MIT