Analogy Weight Check

For every analogy in a substacker draft, verifies it carries mechanical weight — the analogy does real work explaining the mechanism, not merely decorates it. Cross-references analogy-catalog.md for novelty (is this analogy reused from a prior post?) and domain fit (biology > organizational > sports preferred; physics/military disfavored). Use whenever an analogy appears in the draft. Trigger keywords — analogy weight, decorative, mechanical weight, reused analogy, catalog check, metaphor check.

200 stars 25 forksResearch & Science Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add lyndonkl/claude

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add lyndonkl/claude --skill analogy-weight-check
Manual install
git clone --depth 1 https://github.com/lyndonkl/claude.git /tmp/claude
mkdir -p ~/.claude/skills
cp -r /tmp/claude/skills/analogy-weight-check ~/.claude/skills/analogy-weight-check

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Analogy Weight Check

## Table of Contents

- [Mechanical-weight test](#mechanical-weight-test)
- [Workflow](#workflow)
- [Worked example](#worked-example)
- [Guardrails](#guardrails)

**Related skills:** Called by Editor in structural pass (since analogy decisions affect paragraph structure). Reads `shared-context/analogy-catalog.md` for novelty.

## Mechanical-weight test

The test: **if you remove the analogy, does the explanation still work?**

- **Still works** → analogy is decorative. Either cut or extend so it carries weight.
- **Degrades** → analogy carries weight. Keep.

A decorative analogy is not a tier-1 issue by itself — writers may legitimately use decorative language occasionally. But:

- **If the draft has >2 decorative analogies**, flag as a pattern. Cluster of decorative = slop signal.
- **If the analogy is physics/military** AND decorative, flag tier-2 (physics/military are already disfavored directions).

## Workflow

```
For each analogy in the draft:
- [ ] Step 1: Identify the analogy (source + target)
- [ ] Step 2: Mechanical-weight test — simulate removing it; does the explanation degrade?
- [ ] Step 3: Check analogy-catalog.md for reuse
- [ ] Step 4: Check source domain against voice-profile priority (biology > organizational > sports; not physics/military)
- [ ] Step 5: Emit verdict per analogy: carries-weight | decorative | reused-from-catalog | wrong-domain
```

## Worked example

**Draft excerpt**:
Read the full skill on GitHub

Details

Skill name
analogy-weight-check
Path
skills/analogy-weight-check/SKILL.md
Repo updated
1 September 2026

FAQ

What does the Analogy Weight Check skill do?

For every analogy in a substacker draft, verifies it carries mechanical weight — the analogy does real work explaining the mechanism, not merely decorates it. Cross-references analogy-catalog.md for novelty (is this analogy reused from a prior post?) and domain fit (biology > organizational > sports preferred; physics/military disfavored). Use whenever an analogy appears in the draft. Trigger keywords — analogy weight, decorative, mechanical weight, reused analogy, catalog check, metaphor check.

How do I install the Analogy Weight Check skill?

Claude Code plugin: /plugin marketplace add lyndonkl/claude. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Analogy Weight Check popular?

It lives in lyndonkl/claude, which has 200 GitHub stars and 25 forks.

Related skills

Abstraction Concrete Examples

200

lyndonkl/claude

Builds structured abstraction ladders that translate high-level principles into concrete, actionable examples across 3-5 levels. Bridges communication gaps, reveals hidden assumptions, and tests whether abstract ideas work in practice. Use when explaining concepts at different expertise levels, moving between abstract principles and concrete implementation, identifying edge cases by testing ideas against scenarios, designing layered documentation, decomposing complex problems into actionable steps, or bridging strategy-execution gaps.

Testing & QA25

Academic Letter Architect

200

lyndonkl/claude

Guides the creation of evidence-based academic recommendation letters, reference letters, and award nominations that combine concrete examples, meaningful comparisons, and genuine enthusiasm. Use when writing recommendation letters for students, postdocs, or colleagues, or when user mentions recommendation letter, reference, nomination, letter of support, endorsement, or needs help with strong advocacy and comparative statements.

Research & Science25

Adr Architecture

200

lyndonkl/claude

Documents significant architectural and technical decisions with full context, alternatives considered, trade-offs analyzed, and consequences understood. Creates a decision trail that helps teams understand why decisions were made. Use when choosing between technology options, making infrastructure decisions, establishing standards, migrating systems, or when user mentions ADR, architecture decision, technical decision record, or decision documentation.

Software Development25

Brainstorm Diverge Converge

200

lyndonkl/claude

Applies structured divergent-convergent thinking to generate many creative options, organize them into meaningful clusters, then systematically evaluate and narrow to the strongest choices. Balances creative exploration with disciplined decision-making. Use when exploring product ideas, solving open-ended problems, generating strategic alternatives, developing research questions, designing experiments, or when user mentions brainstorming, ideation, divergent thinking, generating options, or evaluating alternatives.

Research & Science25

Career Document Architect

200

lyndonkl/claude

Guides the creation of career documents for academic advancement including research statements, teaching statements, diversity statements, CVs, and biosketches. Combines strategic positioning, narrative coherence, and institutional alignment with authentic representation of contributions and vision. Use when writing or reviewing faculty applications, fellowship statements, promotion packages, award applications, or when user mentions research statement, teaching philosophy, diversity statement, biosketch, academic CV, or career narrative.

Research & Science25

Research Gap Call Verifier

116

CALLE-AI/awesome-phone-call-agents

Turn cited business research into a bounded, approval-gated phone-call plan that asks only unresolved factual questions, then reconcile CALL-E-compatible results without treating voicemail, refusal, ambiguity, or failure as confirmation. Use when web research has produced a shortlist but availability, pricing, policies, or scheduling still require a disclosed call to a published business number.

Research & Science512

Browse the most popular Claude skills, all research & science skills, or write your own with the skills generator.