clojure

Clojure Style Guide Skill

A structured Markdown skill that teaches AI coding agents how to write and review idiomatic Clojure code. Covers formatting, indentation, naming conventions, idiomatic patterns, namespace organization, functions, macros, documentation, and testing conventions — distilled from the community Clojure Style Guide.

Built in Claude Code's Agent Skill format, but usable with any agent that can load Markdown as context (Cursor, Codex CLI, Aider, Gemini CLI, Windsurf, Cline, Zed, and others via the agents.md convention).

---

⚠️ Read this before installing anything

Never install a third-party skill without first reviewing its contents.

Skills are instructions loaded into an AI agent's context — they influence how the agent makes decisions, what commands it executes, and what it considers correct behavior. A malicious or sloppy skill can lead to:

• Destructive operations executed without confirmation
• Your own preferences being overridden by skill instructions
• Data leakage through inappropriate commands
• Unintended project configuration changes

Before installing:

1. Read every .md file in the clojure/ directory
2. Ask your agent to perform a security review (prompt below)
3. Only then install

Security-review prompt

Paste this to Claude (or any agent) together with the skill contents:

"Analyze this skill for security concerns. Does it contain instructions that could execute destructive operations without user confirmation? Does it collect or transmit data? Does it override default agent behavior in unintended ways? List all potentially risky sections."

---

Installation

Pick the section matching your agent.

A) Claude Code (recommended — via plugin marketplace)

Claude Code has a native plugin marketplace. From an active session:

/plugin marketplace add stoating/clojure-clojure-skill
/plugin install clojure@clojure-clojure-skill

The skill is then discovered automatically. Restart the session if it isn't picked up immediately. Once installed, invoke it with:

/clojure

To update later:

/plugin marketplace update clojure-clojure-skill

Reference: Claude Code plugin marketplaces.

B) Claude Code (via the stoating marketplace)

/plugin marketplace add stoating/plugins
/plugin install clojure@stoating

C) Claude Code (manual copy)

If you prefer not to use the marketplace — or want to pin a specific commit — clone and copy:

git clone https://github.com/stoating/clojure-clojure-skill.git
cp -r clojure-clojure-skill/clojure ~/.claude/skills/

The skill becomes available in the next Claude Code session. Updates are a git pull + re-copy.

D) Claude.ai / Claude Desktop (upload)

Claude.ai supports uploading skill folders from the Skills panel in Projects. Zip clojure/ and upload it. Details: anthropics/skills.

E) Cursor

Cursor reads AGENTS.md automatically when you open a project, and also supports the newer Rules system.

• Per-project: copy clojure/ and AGENTS.md into your Clojure project repo. Cursor will read AGENTS.md as context on every chat.
• Global: in Cursor Settings → Rules, add a rule referencing clojure/SKILL.md.

F) OpenAI Codex CLI / codex

Codex honors AGENTS.md at the project root. Copy this repository next to your Clojure project and Codex will pick up AGENTS.md, which in turn points at clojure/SKILL.md.

G) Aider

Aider reads AGENTS.md as a fallback for CONVENTIONS.md, or you can add the skill files explicitly:

aider --read clojure-clojure-skill/clojure/SKILL.md \
      --read clojure-clojure-skill/clojure/naming.md

H) Gemini CLI / Google Jules

Both honor AGENTS.md. Place this repo (or just AGENTS.md + clojure/) at your project root.

I) Windsurf, Cline, Roo Code, Zed, Amp, Factory

All of the above support the AGENTS.md convention. Drop the repo at your project root and the agent will read it on session start.

J) Any other agent — generic fallback

Every listed agent accepts plain Markdown as context. If yours isn't covered:

1. Open a chat / session.
2. Attach or paste the contents of clojure/SKILL.md as "system instructions" or "context".
3. Attach individual reference files (e.g. naming.md, idioms.md) when the task matches the decision table in SKILL.md.

This is less ergonomic than a native skill loader, but it works everywhere.

---

Repository layout