Feynman banner
apolenkov apolenkov

Feynman

Development community

Description

why explain in words when diagram do trick

Installation

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

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