hickey

Analyze PR diffs for structural complexity using Hickey's Simple Made Easy framework.

25|2|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/srid/agency --skill hickey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hickey
Source: https://github.com/srid/agency/tree/main/.apm/skills/hickey
Command: npx skills add https://github.com/srid/agency --skill hickey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers evaluate code for unintended complexity by applying Hickey's Simple Made Easy framework to PR diffs, code snippets, and review trails. It guides reviewers to identify interleaved concerns, fragmentation, and concept multiplication, enabling targeted simplifications.

Core Features & Use Cases

  • Structural analysis of code to spot complecting and fragmentation patterns.
  • Stepwise evaluation across layers (concerns, invariants, abstractions, patterns, entanglement, and severity).
  • Guidance for crafting concrete, implementable simplifications with explicit tradeoffs.

Quick Start

Provide a Hickey-style structural review for the given code diff.

Frequently Asked Questions about hickey

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

FAQPage Schema
How do I evaluate code simplicity in a PR diff?

To evaluate code simplicity in a PR diff, apply Hickey's Simple Made Easy framework to identify interleaving, fragmentation, and concept multiplication. This structural analysis surfaces unintended complexity and proposes concrete simplifications with explicit tradeoffs.

What is structural simplicity analysis in code review?

Structural simplicity analysis in code review is the process of identifying interleaved concerns and concept multiplication using Hickey's framework. It applies a stepwise evaluation across layers like concerns, invariants, abstractions, and entanglement to assess code complexity.

How do I identify interleaving and fragmentation in generated code?

You identify interleaving and fragmentation in generated code by applying a multi-layer analysis workflow that evaluates concerns, invariants, and abstractions. This surfaces complecting patterns and guides targeted simplifications for the generated snippets.

Does Hickey's Simple Made Easy framework work for design discussions?

Yes, Hickey's Simple Made Easy framework works for design discussions by evaluating structural simplicity across concerns, invariants, and entanglement. It guides reviewers to identify complecting patterns and propose actionable improvements with explicit tradeoffs.

What is the best way to reduce concept multiplication in code snippets?

The best way to reduce concept multiplication in code snippets is to perform a stepwise evaluation across concerns, abstractions, and patterns. This structural analysis identifies complecting and guides the crafting of concrete, implementable simplifications.