
cw-analogy
Generate analogy options to explain a concept. Invoke with /cw-analogy or /cw-analogy [concept to explain].
- Installs
- 210
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/everyinc/compound-writing --skill cw-analogy- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads cw-analogy automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Analogy
Purpose
Generate analogy options to make an abstract or complex concept concrete and understandable.
Invocation
/cw-analogy [concept]— Generate analogies for the specified concept/cw-analogy— System asks "What concept do you want to explain?" then generates options- Works on selection if provided, asks if not
How to Generate
-
Understand the concept — What's the core mechanism or principle?
-
Identify the audience — What do they already know? What's familiar to them?
-
Find parallel structures — What everyday experiences share the same underlying pattern?
-
Generate 3 analogies from different domains:
- Physical/tangible world
- Human relationships or social dynamics
- Common activities or processes
-
Test each analogy:
- Does it illuminate the concept?
- Does it hold up under scrutiny (or break in misleading ways)?
- Is it accessible to the target audience?
Output Format
## Analogy Options
### Option 1: [Domain]
[The analogy explained in 2-3 sentences]
### Option 2: [Domain]
[The analogy explained in 2-3 sentences]
### Option 3: [Domain]
[The analogy explained in 2-3 sentences]
---
Which clicks? Or want me to explore a different angle?
Principles
- Familiar vehicle, unfamiliar cargo — The analogy should come from something the reader knows well
- Structural, not surface — The best analogies share underlying mechanisms, not just superficial features
- Know the limits — Every analogy breaks down somewhere; know where yours does
- Concrete beats abstract — "It's like a thermostat" beats "It's like a feedback loop"
What to Avoid
- Analogies that require as much explanation as the original concept
- Clichéd comparisons (tip of the iceberg, double-edged sword)
- Analogies that mislead more than they illuminate
- Mixing metaphors
Lessons
[Skill-specific lessons will be added here as they're captured]
FAQ
What does the cw-analogy skill do?
Generate analogy options to explain a concept. Invoke with /cw-analogy or /cw-analogy [concept to explain].
How do I install cw-analogy?
Run npx skills add https://github.com/everyinc/compound-writing --skill cw-analogy in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cw-analogy/ (personal) or .claude/skills/cw-analogy/ (project).
Which AI agents can use cw-analogy?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is cw-analogy safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains cw-analogy?
It is published by everyinc in everyinc/compound-writing. It has 210 recorded installs.
More from everyinc/compound-writing
cw-sedaris
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-dev-edit
everyinc/compound-writing
Review a draft for big-picture issues in argument, structure, stakes, evidence, and payoff. Use when a piece needs developmental editing, a top-level diagnosis, or substantial restructuring before sentence polish.
cw-brainstorm
everyinc/compound-writing
Help users surface raw material for a piece when they don't have a specific idea yet. Invoke with /cw-brainstorm or when user says they want to explore ideas.
cw-final-pass
everyinc/compound-writing
Run a publication-readiness check on a nearly complete piece and deliver a clear ready, almost-ready, or needs-work verdict. Use when the user asks for a final pass, quality gate, or pre-publication check.
cw-hitchcock
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-sorkin
everyinc/compound-writing
Checks pacing and momentum. Is there enough forward motion? Are you walking and talking or standing still?
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.