hickey

Reviews code for structural simplicity using Rich Hickey's Simple Made Easy framework.

10|2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/nrdxp/predicate --skill hickey-nrdxp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hickey
Source: https://github.com/nrdxp/predicate/tree/main/skills/hickey
Command: npx skills add https://github.com/nrdxp/predicate --skill hickey-nrdxp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Functional tests confirm code works but reveal nothing about whether it is simple; complected and fragmented code passes tests while silently accumulating accidental complexity that surfaces only when you try to change, reason about, or extend it. ## Core Features & Use Cases - Complecting Detection: Scans code for braided concerns such as mutable state, inheritance, scattered conditionals, and callbacks over mutable state, with a catalog of simpler alternatives. - Fragmentation Detection: Finds domain concepts split across fields, modules, or files whose coherence depends on unenforced conventions, and prescribes reunification at the natural layer. - Self-Verification Checklist: Audits the reviewer's own output for dismissed findings, scope-based evasions, and premature closure phrases before results are presented. - Use Case: Before merging a pull request, run this review to get a structured report of concerns, structural pattern matches with line references, severity assessments, concrete simplifications, and a per-finding action list with fix-or-defer dispositions. ## Quick Start Ask the agent to run a hickey structural simplicity review on the changed files in this pull request.

Frequently Asked Questions about hickey

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review code for accidental complexity beyond passing tests?

Run a structural simplicity review that names the distinct concerns, checks for complected constructs like mutable state and inheritance, and detects fragmented domain concepts. Each finding gets a concrete simplified alternative and a fix-or-defer action.

What is complecting in the Simple Made Easy framework?

Complecting means interleaving independent concerns so they cannot be reasoned about in isolation, such as braiding state with time or control flow with callbacks. The review flags catalog matches and requires designing a simpler alternative before any dismissal.

How is fragmentation different from complecting in code review?

Fragmentation splits one domain concept across multiple fields, modules, or files held together by unenforced conventions, while complecting braids separate concerns together. Fragmentation is fixed by reunification at the layer where the concept naturally lives.

Does this review run tests or build commands?

No, the workflow is purely analytical and explicitly forbids running tests, builds, or shell commands. It reads code, reasons about structure, and reports findings with line references.

When should I use the lowy review instead of hickey?

Use lowy for the temporal half of code review, analyzing volatility-based decomposition and whether boundaries encapsulate axes of change. Hickey covers the spatial half, examining what is tangled in the code right now; running both gives full coverage.