bydietrichgebert· 6 skills
Quick reference for ponytail's modes, skills, and commands. One-shot display.
$npx -y skills add dietrichgebert/ponytail --skill ponytail-helpInstalls into the current project.
Run `npx skills use "https://github.com/dietrichgebert/ponytail" --skill "dietrichgebert/ponytail/ponytail-help"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/dietrichgebert/ponytail" that are relevant to the current task. Run `npx skills add "https://github.com/dietrichgebert/ponytail"` and select the relevant skills, then follow their instructions.
| 1 | # Ponytail Help |
| 2 | |
| 3 | Display this reference card when invoked. One-shot, do NOT change mode, |
| 4 | write flag files, or persist anything. |
| 5 | |
| 6 | ## Levels |
| 7 | |
| 8 | | Level | Trigger | What change | |
| 9 | |-------|---------|-------------| |
| 10 | | **Lite** | `/ponytail lite` | Build what's asked, name the lazier alternative in one line. | |
| 11 | | **Full** | `/ponytail` | The ladder enforced: YAGNI → stdlib → native → one line → minimum. Default. | |
| 12 | | **Ultra** | `/ponytail ultra` | YAGNI extremist. Deletion before addition. Challenges requirements before building. | |
| 13 | |
| 14 | Level sticks until changed or session end. |
| 15 | |
| 16 | ## Skills |
| 17 | |
| 18 | | Skill | Trigger | What it does | |
| 19 | |-------|---------|--------------| |
| 20 | | **ponytail** | `/ponytail` | Lazy mode itself. Simplest solution that works. | |
| 21 | | **ponytail-review** | `/ponytail-review` | Over-engineering review: `L42: yagni: factory, one product. Inline.` | |
| 22 | | **ponytail-audit** | `/ponytail-audit` | Whole-repo over-engineering audit: ranked list of what to delete. | |
| 23 | | **ponytail-debt** | `/ponytail-debt` | Harvest `ponytail:` shortcut comments into a tracked ledger. | |
| 24 | | **ponytail-gain** | `/ponytail-gain` | Measured-impact scoreboard: less code, less cost, more speed. | |
| 25 | | **ponytail-help** | `/ponytail-help` | This card. | |
| 26 | |
| 27 | Codex uses `@ponytail`, `@ponytail-review`, and `@ponytail-help`; Claude Code |
| 28 | and OpenCode use the slash-command forms above (OpenCode ships all six as |
| 29 | slash commands). |
| 30 | |
| 31 | ## Deactivate |
| 32 | |
| 33 | Say "stop ponytail" or "normal mode". Resume anytime with `/ponytail`. |
| 34 | `/ponytail off` also works. |
| 35 | |
| 36 | ## Configure Default Mode |
| 37 | |
| 38 | Default mode = `full`, auto-active every session. Change it: |
| 39 | |
| 40 | **Environment variable** (highest priority): |
| 41 | ```bash |
| 42 | export PONYTAIL_DEFAULT_MODE=ultra |
| 43 | ``` |
| 44 | |
| 45 | **Config file** (`~/.config/ponytail/config.json`, Windows: `%APPDATA%\ponytail\config.json`): |
| 46 | ```json |
| 47 | { "defaultMode": "lite" } |
| 48 | ``` |
| 49 | |
| 50 | Set `"off"` to disable auto-activation on session start, activate manually |
| 51 | with `/ponytail` when wanted. |
| 52 | |
| 53 | Resolution: env var > config file > `full`. |
| 54 | |
| 55 | ## Update |
| 56 | |
| 57 | Enable auto-update once: open `/plugin`, go to Marketplaces, pick ponytail, Enable auto-update. Claude Code then pulls new versions at startup (run `/reload-plugins` when it prompts). Manual refresh: `/plugin marketplace update ponytail` then `/reload-plugins`. |
| 58 | |
| 59 | If `/plugin` is not recognized, your Claude Code is out of date. Update it (`npm install -g @anthropic-ai/claude-code@latest`, or `brew upgrade claude-code`) and restart. Other hosts use their own update flow. |
| 60 | |
| 61 | ## More |
| 62 | |
| 63 | Full docs + examples: https://github.com/DietrichGebert/ponytail |