Agent skill

Hickey

by srid in srid/emanote

Evaluate code (especially LLM-generated) for structural simplicity using Rich Hickey's "Simple Made Easy" framework.

Custom licenceAuto-check passedData & Analytics

Install Hickey

skills CLI
$ npx skills add srid/emanote --skill hickey -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install srid/emanote hickey --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/srid/emanote.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/hickey .claude/skills/hickey && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hickey
GitHub stars
963
Token cost
~6.8k tokens
SKILL.md length
3,857 words
Files
2
Skills in repo
25
Repo updated
First seen
Licence
Custom licence

At a glance

Evaluate code (especially LLM-generated) for structural simplicity using Rich Hickey's "Simple Made Easy" framework.

  • Works in 5 steps: Enumerate invariants. Write out every… → Check consumption sites, not just… → Watch for reconciliation machinery. A… → …
  • The user asks about complecting
  • SKILL.md covers Key Definitions, Scope of Review, The Evaluation Process and Fact-Check Your Own Evaluation, plus 2 more sections
  • Calls git

What it does

Hickey is an agent skill from srid/emanote. Evaluate code (especially LLM-generated) for structural simplicity using Rich Hickey's "Simple Made Easy" framework. Use this skill whenever reviewing a PR, diff, or code snippet for accidental complexity — particularly when the code was generated by an AI coding assistant and line-by-line review isn't feasible. Also use when the user asks about complecting, simplicity vs. easiness, structural coupling, or concept deduplication. Trigger on phrases like "is this simple", "does this complect", "review for…

Its SKILL.md is about 6.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `transcript.md`).

It sits in Data & Analytics, covering Data cleaning. The repository describes itself as: Emanate a structured view of your plain-text notes.

When your agent uses it

  • The user asks about complecting
  • Phrases like is this simple
  • Does this complect
  • Review for complexity

Example prompts

  • “Simple Made Easy”
  • “is this simple”
  • “does this complect”
  • “/hickey”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Enumerate invariants. Write out every rule coupling the parts, in plain language: "if A then B", "all Xs agree on Y", "when kind=X then…
  2. Check consumption sites, not just definitions. Fragmentation is most visible at the reader. If every consumer projects the same value out…
  3. Watch for reconciliation machinery. A memo that lifts one value out of a collection; a callback that writes back into the collection; an…
  4. Collapse at the natural layer. Pick the representation layer where the one thing naturally lives. Sometimes that's a discriminated union…
  5. Silence is the bug. A review that skips this layer because "no invariants came to mind" is the same review that misses the fragmentation…

What it can do on your machine

Read from SKILL.md and the folder at commit 9d01037. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hickey loads about 6.8k tokens when it runs. Until then it costs about 154 tokens; SKILL.md has 3,857 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~154
When it runs · the whole SKILL.md, loaded when a task matches
~6.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 3,857 words (~6,781 tokens).

“Evaluate code for structural simplicity using Rich Hickey's "Simple Made Easy" framework. This skill is designed for the world where AI generates code faster than humans can read it — where functional tests pass but accidental complexity accumulates silently.”

— opening of SKILL.md by srid, Custom licence
name
hickey
context
fork
agent
Explore
model
sonnet

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/hickey of srid/emanote.

  • SKILL.md
  • transcript.md

Open the folder on GitHubat commit 9d01037

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in srid/emanote, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hickey next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hickey compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hickey this skillsrid/emanote963—~6.8kAutomated safety check: PassCustom licence
Question2reportrefraction-ray/xalpha2.7k—~3.2kAutomated safety check: PassMIT
Dingo VerifyMigoXLab/dingo757—~741Automated safety check: NotesApache-2.0
Data Validationplatonai/Browser41.2k—~896Automated safety check: PassApache-2.0
Pandas ProJeffallan/claude-skills12k1 repos~1.5kAutomated safety check: PassMIT
Issues DeduplicationJetBrains/ideavim10k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Question2report

    refraction-ray/xalpha

    Turn a natural-language financial question into a polished, self-contained HTML report.

    2.7k GitHub stars~3.2k tokensUpdated 2 mo ago
    Data & AnalyticsAuto-check passed
  • Dingo Verify

    MigoXLab/dingo

    A skill your agent uses when the user wants to fact-check an article or verify factual claims in a document.

    757 GitHub stars~741 tokensUpdated yesterday
    Data & AnalyticsAuto-check: notes
  • Data Validation

    platonai/Browser4

    Validates data against common and custom rules (required fields, formats, ranges).

    1.2k GitHub stars~896 tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Pandas Pro

    Jeffallan/claude-skills

    Handles pandas DataFrame work: cleaning, merging, groupby aggregation, pivots, time-series resampling and memory tuning, with checks on dtypes, shapes and nulls.

    12k GitHub starsUsed in 1 repo~1.5k tokens
    Data & AnalyticsAuto-check passed
  • Issues Deduplication

    JetBrains/ideavim

    Official

    Handles deduplication of YouTrack issues. An agent skill from JetBrains/ideavim.

    10k GitHub stars~1.3k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Openbb Data Fetcher

    monarchjuno/vibe-investing

    Fetch financial, market, economic, fundamental, news, options, crypto, ETF, index, and macro data through the OpenBB Python interface instead of the OpenBB MCP server.

    299 GitHub stars~2.9k tokensUpdated 5 mo ago
    Data & AnalyticsAuto-check: notes

More from srid/emanote

All 25 skills in this repo
  • Codex Debate

    srid/emanote

    Run an automated codex⇄Claude debate to consensus — no round cap, no deadlock exit.

    963 GitHub stars~8.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Do

    srid/emanote

    Do a task end-to-end — implement, PR, CI loop, ship. An agent skill from srid/emanote.

    963 GitHub stars~12k tokensUpdated 2 mo ago
    Auto-check passed
  • Be Review

    srid/emanote

    Run /be's review gauntlet SERIALLY — /lens-debate (lowy ⇄ hickey), then /codex-debate, then /simplify, then code-police, each editing and committing on the live branch in turn.

    963 GitHub stars~4.2k tokensUpdated 2 mo ago
    Auto-check passed
  • CI

    srid/emanote

    Reference for the odu runner — how to invoke a full pipeline, a single recipe, or a platform-pinned node, and how to attach to a live run, from a project whose CI odu runs.

    963 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Forge PR

    srid/emanote

    Write engaging PR titles and descriptions for any forge (GitHub today; Bitbucket planned).

    963 GitHub stars~2.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Kolu

    srid/emanote

    Drive one AI agent from another through kolu's terminals: spawn a Claude Code / Codex / opencode session in a PTY, prompt it, watch the screen for its reply, read it, and prompt again — a…

    963 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Hickey

What does Hickey do?

Evaluate code (especially LLM-generated) for structural simplicity using Rich Hickey's "Simple Made Easy" framework. Hickey is an agent skill from srid/emanote. Evaluate code (especially LLM-generated) for structural simplicity using Rich Hickey's "Simple Made Easy" framework.

When should I use Hickey?

Hickey fits situations like: the user asks about complecting; phrases like is this simple; does this complect; review for complexity.

How do I install Hickey in Claude Code?

Run `npx skills add srid/emanote --skill hickey -a claude-code`. Or copy the skill folder (.agents/skills/hickey in srid/emanote) into .claude/skills/hickey in your project. Claude Code loads it when a task matches its description.

How do I install Hickey in Codex?

Run `npx skills add srid/emanote --skill hickey -a codex`. Or copy the skill folder (.agents/skills/hickey in srid/emanote) into .agents/skills/hickey in your project. Codex loads it when a task matches its description.

Can I use Hickey in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add srid/emanote --skill hickey -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hickey, .gemini/skills/hickey, .github/skills/hickey and .opencode/skills/hickey in your project.

What does Hickey need to run?

Going by SKILL.md and its folder, Hickey needs the command-line tools its instructions call (git).

Does Hickey access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Hickey safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hickey use?

Hickey has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Hickey use?

About 6.8k tokens (SKILL.md is roughly 27k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hickey?

Skills that share tags, products or a category with Hickey: Question2report (refraction-ray/xalpha, 2.7k stars), Dingo Verify (MigoXLab/dingo, 757 stars), Data Validation (platonai/Browser4, 1.2k stars) and Pandas Pro (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hickey?

srid (a GitHub user) maintains it in srid/emanote, which has 963 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on July 26, 2026.

Source: srid/emanote on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.