Agent Skill
2/7/2026

writing-clojure-docstrings

Guidelines for writing effective Clojure docstrings with markdown formatting, wikilinks, code examples, and tables. Always use this skill when writing or reviewing docstrings in Clojure code, or when asked about docstring formatting and style. Triggers on (1) writing new functions/vars/namespaces with docstrings, (2) updating existing docstrings, (3) questions about docstring best practices, (4) reviewing code with docstrings.

R
rcmerci
2GitHub Stars
1Views
npx skills add RCmerci/skills

SKILL.md

Namewriting-clojure-docstrings
DescriptionGuidelines for writing effective Clojure docstrings with markdown formatting, wikilinks, code examples, and tables. Always use this skill when writing or reviewing docstrings in Clojure code, or when asked about docstring formatting and style. Triggers on (1) writing new functions/vars/namespaces with docstrings, (2) updating existing docstrings, (3) questions about docstring best practices, (4) reviewing code with docstrings.

Skills Repository

This repository contains reusable Codex skills and utilities for working with ClojureDocs → Logseq imports.

Repository layout

  • skills/ — all skill packages (<skill-name>/SKILL.md)
  • src/ — Clojure source code
  • test/ — tests
  • docs/agent-guide/ — planning and implementation documents

Requirements

Common commands

  • bb tasks — list available tasks
  • bb test — run all tests
  • bb run link-skills — link repo skills into destination roots
  • bb run unlink-skills — remove repo-owned skill symlinks from destination roots

Skill link configuration

link-skills and unlink-skills support these environment variables:

  • SKILLS_DEST_ROOTS — destination roots separated by your OS path separator (: on macOS/Linux)
  • SKILLS_SOURCE_ROOT — optional source root override (defaults to <repo>/skills)

Default destination roots:

  • ~/.codex/skills
  • ~/.config/opencode/skills
  • ~/.config/eca/skills
Skills Info
Original Name:writing-clojure-docstringsAuthor:rcmerci