Clojure Skills

clojure-skills

An [Agent Skill](https://agentskills.io) that gives a coding agent Clojure-aware tools in place of the line-oriented ones it would otherwise reach for: structural search and editing instead of `sed`, a file outline instead of reading two thousand lines, failing assertions instead of a test log, and the three project frames of a stacktrace instead of sixty.

Follows the [Agent Skills](https://agentskills.io) open standard, so it works with Claude Code, Codex CLI, Gemini CLI and the other clients that adopted it. Covers `.clj`, `.cljs`, `.cljc`, `.cljd`, `.edn`, `.bb` and `.lpy`.

Install

git clone https://github.com/chaploud/clojure-skills.git ~/clojure-skills
cd ~/clojure-skills
bb install

That installs one binary, `clj-skill`, and then runs `clj-skill doctor`, which reports what works on your machine and how to enable the rest. Running it again is safe.

Then link the skill where your agents look for one:

# Codex CLI and Gemini CLI both read this one
mkdir -p ~/.agents/skills && ln -s ~/clojure-skills ~/.agents/skills/clojure-skills

# Claude Code
mkdir -p ~/.claude/skills && ln -s ~/clojure-skills ~/.claude/skills/clojure-skills

Requirements

Tool	Required	Install
Babashka	yes	brew install borkdude/brew/babashka
bbin	yes	bb install io.github.babashka/bbin
ripgrep	no	brew install ripgrep — keeps find fast on large trees
clojure-lsp	no	brew install clojure-lsp/brew/clojure-lsp-native — enables clj-skill lsp
cider-nrepl	no	a REPL dependency, see below — enables clj-skill cider

Nothing optional is assumed: a command whose prerequisite is missing says so and names the alternative, rather than failing or quietly returning nothin