writing-clj-kondo-hooks

What problem does it solve?

Developers need to extend clj-kondo linting for custom macros but lack guidance and ready-to-use hooks, making linting incomplete and error‑prone.

Core Features & Use Cases

• Hook Types: Provides guidance for creating both analyze-call hooks (precise transformation) and macroexpand hooks (simpler macro expansion).
• API Reference: Details the clj-kondo.hooks-api functions for node construction, lint registration, and analysis utilities.
• Workflow Steps: Shows how to read configuration, write the hook code, register it, and test with clj-kondo.
• Use Case: Ideal for library authors who define new macros and want clj‑kondo to understand them without manual lint suppression.

Quick Start

Use the writing-clj-kondo-hooks skill to create a clj‑kondo hook that rewrites a custom macro call into a let expression.