hiccup

Clojure Hiccup Skill

A structured Markdown skill that teaches AI coding agents how to work with Hiccup - the Clojure library for representing HTML with data structures and rendering it safely. Covers Hiccup syntax, Hiccup 2 rendering, escaping, raw HTML, render modes, helper namespaces, Ring responses, forms, and migration from legacy Hiccup 1 code.

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 hiccup/ directory
2. Ask your agent to perform a security review
3. Only then install

Installation

Claude Code via plugin marketplace

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

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

/hiccup

To update later:

/plugin marketplace update clojure-hiccup-skill

Claude Code via the stoating marketplace

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

Manual or Other Agents

Agents that honor AGENTS.md can use this repository directly. Otherwise attach or load hiccup/SKILL.md, then load the referenced Markdown files as needed.

Repository layout

.
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── AGENTS.md
├── README.md
└── hiccup/
    ├── SKILL.md
    ├── syntax.md
    ├── rendering.md
    ├── helpers.md
    ├── workflows.md
    └── anti-patterns.md

What the skill covers

File	Contents
SKILL.md	Entry point, decision table, core mental model
syntax.md	Vectors, attributes, selector shorthand, seq expansion, class/style values
rendering.md	Hiccup 2, Hiccup 1 compatibility, escaping, raw, render modes
helpers.md	Page, form, element, URL, and base-url helpers
workflows.md	Dependencies, Ring responses, layouts, reusable views, forms, tests, migration
anti-patterns.md	XSS risks, premature rendering, invalid sibling vectors, brittle tests

Sources

• weavejester/hiccup - source, README, tests, and syntax docs
• Hiccup API docs

License

See LICENSE.