Skip to content

utk2103/Prompt-Studio / skills/lean-help

lean-help

Verified

Quick-reference card for all Lean modes, skills, and commands. One-shot display, not a persistent mode: shows the card and exits without switching levels, writing flag files, or persisting anything. Trigger: /lean-help, "lean help", "what lean commands", "how do I use lean", "lean cheatsheet", "lean reference".

Lean Help

Display this reference card when invoked. One-shot only — do NOT change mode, write flag files, touch ~/.claude/.lean-active, or persist state of any kind. If the user wants to switch modes, point them at the trigger.


Levels at a glance

LevelTriggerRule of thumbDiff shape
Lite/prompt-studio:lean liteBuild what's asked. Name the lazier alternative in one line.Requested code + 1-line footnote.
Full/prompt-studio:lean (default)The ladder: YAGNI → reuse → stdlib → native → installed dep → one line → minimum.Shortest working diff. ≤3 lines of prose.
Ultra/prompt-studio:lean ultraYAGNI extremist. Deletion beats addition. Challenges the requirement before building.Often zero code + a question back.

Level sticks until you change it or the session ends. Persisted in ~/.claude/.lean-active so it survives across turns.

Same task, three levels

Task: "Add a cache for these API responses."

LevelResponse
LiteCustom TTLCache class as asked. Note: functools.lru_cache(maxsize=1000) covers it in one line.
Full@lru_cache(maxsize=1000) on the fetch function. Skipped custom cache, add when lru_cache measurably falls short.
UltraDo these responses actually re-fetch? Show me a hot path. If yes: @lru_cache. If not: skip.

Skills

SkillTriggerWhat it does
lean/prompt-studio:lean [lite|full|ultra]Lazy mode itself. Shortest solution that actually works.
compress/prompt-studio:compress FILECompress a memory file (CLAUDE.md, todos, prefs) into Lean shorthand. Backup at FILE.original.md.
lean-audit/prompt-studio:lean-auditWhole-repo over-engineering audit. Ranked list of what to delete/simplify across the codebase.
lean-commit/prompt-studio:lean-commitGenerate a terse Conventional Commits message for staged changes. Message only — never runs git.
lean-debt/prompt-studio:lean-debtHarvest lean: comments into a debt ledger so deferrals get tracked, not forgotten.
lean-gain/prompt-studio:lean-gainMeasured impact scoreboard — less code, more speed (no cost claim).
lean-review/prompt-studio:lean-reviewReview a diff for over-engineering only. One line per finding: what to cut, what replaces it.
lean-help/prompt-studio:lean-helpThis card.

Codex users: @lean, @compress, @lean-audit, @lean-commit, @lean-debt, @lean-gain, @lean-review, @lean-help. OpenCode and Claude Code: slash-command forms above.


The ladder (full mode)

Stop at the first rung that holds:

  1. Needs to exist? Speculative → skip, one-line note. (YAGNI)
  2. Already in this codebase? Helper/util/type nearby → reuse.
  3. Stdlib does it? Use it.
  4. Native platform feature? <input type="date"> over picker lib, CSS over JS, DB constraint over app code.
  5. Installed dep solves it? Use it. Never add a new dep for what a few lines can do.
  6. One line? One line.
  7. Only then: minimum code that works.

Deactivate / resume

ActionSay
Turn offstop lean, normal mode, or /prompt-studio:lean off
Resume/prompt-studio:lean (or with a level)
Check currentcat ~/.claude/.lean-active

Configure default mode

Default is full, auto-active every session. Override:

Environment variable (highest priority):

export LEAN_DEFAULT_MODE=ultra   # lite | full | ultra | off

Config file — ~/.config/lean/config.json (Windows: %APPDATA%\lean\config.json):

{ "defaultMode": "lite" }

Set "off" to disable auto-activation on session start; activate manually with /prompt-studio:lean when wanted.

Resolution order: env var → config file → full.


MCP surface

The lean-mcp server exposes the same builder used by the FastAPI adapters (app/services/formats.build_messages) and this plugin — one source of truth in app/services/skills.py, no drift between transports. Wire it into any MCP-compatible client to get Lean shaping without the plugin.


Troubleshooting

SymptomFix
Mode reverts every turn~/.claude/.lean-active not writable — check perms.
/lean-help prints nothingSkill not loaded. Reinstall (see Update).
Default mode ignoredEnv var wins over config file — unset LEAN_DEFAULT_MODE.
Want Lean only in one repoAdd project-level hook, not global env var.
Conflicts with caveman prose modeFine — Lean shapes code, caveman shapes prose. Run both.

Update

/plugin marketplace update prompt-studio
/plugin install lean@prompt-studio

Or turn on auto-update in /plugin → Marketplaces. Codex and OpenCode use their own reinstall flow from the repo.


More

Full docs, examples, and source: https://github.com/utk2103/Prompt-Studio

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall