A collection of AI skills for development work, primarily Go. Compatible with Claude Code and other agents that read the .agents/skills convention.
| File | Purpose |
|---|---|
| AGENTS.md | The agent's identity, working style, git policy, mandatory-skill triggers, and layer-conversion reference. |
| CLAUDE.md | Claude Code entry point — points at AGENTS.md. |
| Skill | Purpose |
|---|---|
| use-modern-go | Apply modern Go syntax based on the project's Go version. |
| layered-architecture-types | Enforce primitives-at-edges / strong-types-in-Business layering and the toBus/fromBusResponse/toDB converter pattern. |
| business-layer-extensions | Add cross-cutting concerns (OTEL, logging, metrics) via the ExtBusiness/Extension decorator seam. |
| branching-logic-flow | Prefer defaulting and naked switches over if/else chains for shallow branching. |
| pr-review | Read-only PR review lenses for correctness, error visibility, comments, tests, contracts, and simplification across all repo languages. |
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 pr-review@ardanlabs
/reload-plugins
Available plugins: use-modern-go, layered-architecture-types, business-layer-extensions, branching-logic-flow, pr-review.
Plugin skills are namespaced, so pr-review is invoked as /pr-review:pr-review. Pull newer versions with /plugin marketplace update ardanlabs — plugins are unpinned, so every commit to main is a new version.
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. |
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
.claude/skills is a symlink so Claude Code and .agents-aware tools share one source.
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