apolenkov

Feynman — Development skill for Claude Code

Development community

why explain in words when diagram do trick.

How to install Feynman

This entry records only its repository, not the path inside it, so there is no exact command to give. Open apolenkov/feynman and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Feynman does

why explain in words when diagram do trick.

Alternatives in Development

  • Diagram 2.3k ★
  • Eli5 — Say the last answer again in plain words — same facts, in the order the operator needs them 49 ★
  • Openhop Flow — Render an animated OpenHop flow diagram for the prompt that follows 41 ★

README

feynman

![CI](https://github.com/apolenkov/feynman/actions/workflows/ci.yml/badge.svg?label=CI&color=2563EB) ![npm](https://img.shields.io/npm/v/@albinocrabs/feynman?color=2563EB) ![License](https://img.shields.io/github/license/apolenkov/feynman?color=2563EB) [![skills.sh](https://skills.sh/b/apolenkov/feynman)](https://skills.sh/apolenkov/feynman)

feynman is a Codex plugin and local CLI that makes structured answers easier to read. It injects concise diagram guidance at Codex session start and provides a standalone linter for ASCII visuals.

Install

Native Codex plugin

codex plugin marketplace add apolenkov/feynman --ref main
codex plugin add feynman@feynman

Open `/plugins` in Codex to search for **Feynman**, install it, then start a new session. The skill is discoverable for visual architecture, ASCII diagrams, flows, trees, comparisons, priorities, and status summaries.

skills.sh (Codex)

For teams that distribute skills through [skills.sh](https://www.skills.sh/), install the same Codex-only skill directly from this repository:

npx skills add apolenkov/feynman --skill feynman --agent codex --global --yes

The skill delegates state changes to the published CLI through `npx`; it does not install or configure any non-Codex integration. The skills.sh catalog is indexed asynchronously after installations, so a newly released source can take a short time to appear in search.

Local hook and CLI

npx -y @albinocrabs/feynman@latest install
npx -y @albinocrabs/feynman@latest doctor

The installer targets Codex by default and writes only to `~/.codex`. It is idempotent. Uninstall with:

npx -y @albinocrabs/feynman@latest uninstall

The native plugin supplies the Codex skill. The CLI installer registers the `SessionStart` hook that injects the selected ruleset into a session.

What it does

feynman classifies a response's structure and chooses the smallest useful visual: flow, tree, table, status m