cl-macro-design

Hygienic macros prevent variable capture by using gensym to generate unique symbols that won't collide with user code. This Skill enforces hygienic macro construction techniques in Common Lisp to ensure safe, reusable macro designs that avoid unintended variable bindings.

Best practices include single-evaluation argument handling—ensuring macro arguments are evaluated exactly once—and using established patterns like with-open and call-with styles. This Skill covers macro-design patterns, expansion verification, and templates that prevent multiple evaluations and unsafe argument handling.

Macro expansion verification uses macroexpand-1 for single-step expansion and full expansion checking, with SLIME integration for interactive verification. This Skill provides workflows to inspect and validate macro expansions before deployment.

Yes. This Skill provides documented macro-design pattern templates—including with-open-database, do-lines, and define-api-endpoint—that enforce hygienic construction and gensym-safe bindings for reliable, reusable macro abstractions in Common Lisp projects.

Unsafe macro design stems from variable capture, multiple evaluation of arguments, and uncontrolled code generation. This Skill identifies and resolves these problems through hygienic macro enforcement, single-evaluation patterns, and documented design workflows following Google-style macro guidelines.