Skip to content
ardanlabsPublic

About

A set of AI skills useful for (Go) development

Resources

Stars

7 stars

Watchers

1 watching

Forks

Repository files navigation

skills

A collection of AI skills for development work, primarily Go. Compatible with Claude Code and other agents that read the .agents/skills convention.

Agent instructions

File Purpose
AGENTS.md The agent's identity, working style, git policy, and mandatory-skill triggers.
CLAUDE.md Claude Code entry point — points at AGENTS.md.

Skills

Skill Purpose
use-modern-go Apply modern Go syntax based on the project's Go version.
ardan-service-architecture Service layering (primitives at edges, strong types in Business, named converters), the ExtBusiness/Extension decorator seam, and default-first branching.
ardan-pr-review Guided read-only PR review for code and infrastructure in any language: scripted intake and per-ecosystem checks, stack discovery, parallel lens agents, issues-only findings and color-coded Mermaid diagrams.

Install as a Claude Code plugin

This repo is a Claude Code plugin marketplace named ardanlabs. Each skill is a separate plugin, so you install only the ones you want.

/plugin marketplace add ardanlabs/skills
/plugin install ardan-pr-review@ardanlabs
/reload-plugins

Available plugins: use-modern-go, ardan-service-architecture, ardan-pr-review.

Plugin skills are namespaced, so ardan-pr-review is invoked as /ardan-pr-review:ardan-pr-review. Pull newer versions with /plugin marketplace update ardanlabs — plugins are unpinned, so every commit to main is a new version.

PR review tools

ardan-pr-review runs the tools below when the change needs them, per ecosystem (Go module, crate, Terraform module, chart, …). A missing tool is listed with its install command at the start of a review, and its check is skipped. Go tools built with an older Go than the active toolchain are flagged for a rebuild: analyzers fail on a newer standard library. Ecosystems not listed here are found by a discovery agent, which also lists the repo's own quality gates (Makefile, CI, pre-commit).

The reviewed code never runs unless it's a maintainer's PR. Tests, cargo clippy/check/test, Terraform init/validate, linter plugins (tflint, mypy, ansible-lint, golangci-lint), the repo's own gates, and security PoCs run only for --pr when GitHub reports that the PR author has write access and the head branch is in the base repo. Any other change gets the read-only checks, with neutral configs where a repo config could load code.

Tool Checks Install
go (build, vet, test -race, fix -diff, mod tidy -diff, gofmt) build, vet, tests and data races, modernizers, module and format hygiene go.dev/dl; -race needs cgo and a C compiler
staticcheck Go correctness and simplifications go install honnef.co/go/tools/cmd/staticcheck@latest
golangci-lint the repo's own lint config, when it has one go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@latest
checklocks +checklocks lock and atomic annotations go install gvisor.dev/gvisor/tools/checklocks/cmd/checklocks@go
errcheck unchecked errors go install github.com/kisielk/errcheck@latest
nilaway nil dereferences go install go.uber.org/nilaway/cmd/nilaway@latest
deadcode unreachable functions go install golang.org/x/tools/cmd/deadcode@latest
apidiff exported Go API breaks against the base commit go install golang.org/x/exp/cmd/apidiff@latest
gosec Go security go install github.com/securego/gosec/v2/cmd/gosec@latest
govulncheck known vulnerabilities go install golang.org/x/vuln/cmd/govulncheck@latest
dupl Go clones go install github.com/mibk/dupl@latest
gopls symbol lookups by reviewers go install golang.org/x/tools/gopls@latest
buf proto lint and breaking changes (buf.yaml) go install github.com/bufbuild/buf/cmd/buf@latest
gitleaks secrets in the diff go install github.com/zricethezav/gitleaks/v8@latest
shellcheck shell scripts shellcheck#installing
jscpd JS/TS clones npm install -g jscpd
semgrep the repo's own semgrep rules, when it has them python3 -m pip install semgrep
cargo (fmt --check, clippy, test) Rust format, lints, tests (--locked) rustup.rs; rustup component add clippy rustfmt
cargo-audit, cargo-deny Rust advisories; licenses and sources (deny.toml) cargo install cargo-audit cargo-deny --locked
terraform or tofu (fmt, init -backend=false, validate) Terraform/OpenTofu format and validation; init uses a temp data dir and leaves the lock file as it was terraform, opentofu
tflint Terraform lint (repo .tflint.hcl) tflint#installation
helm (lint, template) chart lint and render helm.sh
kustomize or kubectl kustomize render Kustomize roots go install sigs.k8s.io/kustomize/kustomize/v5@latest
kubeconform K8s schema validation of manifests and renders go install github.com/yannh/kubeconform/cmd/kubeconform@latest
kube-linter K8s best practices go install golang.stackrox.io/kube-linter/cmd/kube-linter@latest
trivy (else checkov) IaC misconfiguration: Terraform, charts, manifests, Dockerfiles trivy.dev
ruff, mypy, pytest Python lint/format, types (repo config), tests python3 -m pip install ruff mypy pytest
bandit, pip-audit Python security; advisories (requirements*.txt) python3 -m pip install bandit pip-audit
ansible-lint, yamllint Ansible lint; YAML lint (repo config) python3 -m pip install ansible-lint yamllint
hadolint Dockerfiles hadolint#install
actionlint, zizmor GitHub Actions lint and security go install github.com/rhysd/actionlint/cmd/actionlint@latest; python3 -m pip install zizmor

checklocks is installed from gVisor's go branch, the only one that builds with plain go install.

Changes to the skill's scripts are verified by make test-pr-review (see zarf/tests/ardan-pr-review): a fixture repo covering every supported ecosystem, golden results, and sh ↔ PowerShell parity, with stub analyzers on the host and the real tools above in a pinned Docker image.

Claude Code settings

Example Claude Code configuration, split into global (user-level) and project-level.

File Purpose
global/.claude/settings.json User settings: permission allow/deny lists, model, plugins, Go-version SessionStart hook.
global/claude.json MCP servers (gopls, goland).
global/statusline.sh Powerline statusline: model, dir, git state, context/cost/edits.
project/.claude/settings.json Shared project settings: git/gh permissions, git-policy PreToolUse hook, SessionStart instructions.
project/.claude/settings.local.json Local per-machine permission grants (example).
project/.claude/hooks/git-policy-reminder.py PreToolUse hook reminding the agent of git/GitHub policy before write ops.

Layout

AGENTS.md           # agent identity, policy, and skill triggers
CLAUDE.md           # Claude Code entry point -> AGENTS.md
.agents/skills/     # canonical skill files
.claude/skills      # symlink -> ../.agents/skills
.claude-plugin/     # marketplace.json — plugin catalog pointing at .agents/skills
claude/global/      # example user-level Claude Code config
claude/project/     # example project-level Claude Code config
Makefile            # `make test`: lint + skill test suites
zarf/tests/         # skill test suites (ardan-pr-review: fixture, golden results, tools image)
.github/workflows/  # CI running those suites

.claude/skills is a symlink so Claude Code and .agents-aware tools share one source.

Windows setup

Important

The .claude/skills symlink requires git symlink support on Windows. Without it, git checks out the link as a plain text file and skills fail to load.

Enable it before cloning:

git config --global core.symlinks true

Creating the symlink also needs OS permission to do so — either run git in an elevated (admin) shell, or enable Windows Developer Mode (Settings → Privacy & security → For developers).

If a clone already checked out .claude/skills as a text file:

git config core.symlinks true
git checkout -- .claude/skills

About

A set of AI skills useful for (Go) development

Resources

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages