ponytail-help
GitHubPonytail 插件的快速参考文档，展示 Lite/Full/Ultra 三种模式、六大核心技能（如代码审查、审计、技术债管理）及配置更新方法。提供触发命令与使用指南，帮助用户快速上手和切换状态。
Trigger Scenarios
Install
npx skills add DietrichGebert/ponytail --skill ponytail-help -g -y
SKILL.md
Frontmatter
{
"name": "ponytail-help",
"license": "MIT",
"homepage": "https:\/\/github.com\/DietrichGebert\/ponytail",
"description": "Quick reference for ponytail's modes, skills, and commands. One-shot display."
}
Ponytail Help
Display this reference card when invoked. One-shot, do NOT change mode, write flag files, or persist anything.
Levels
| Level | Trigger | What change |
|---|---|---|
| Lite | /ponytail lite |
Build what was asked, name the smaller option in one line. |
| Full | /ponytail |
The smallest complete change, a check where the logic needs one, and a reply that names what was skipped and any risk. Default. |
| Ultra | /ponytail ultra |
Also questions the request and pushes back before building. |
Level sticks until changed or session end.
Skills
| Skill | Trigger | What it does |
|---|---|---|
| ponytail | /ponytail |
Lazy mode itself: least new code, clear replies that name skipped work and risks. |
| ponytail-review | /ponytail-review |
Quality review of a diff: bugs, security, load, missing tests, speed, what to cut. Each finding says what goes wrong and how to fix it. |
| ponytail-audit | /ponytail-audit |
The same quality review for the whole repo, ranked. |
| ponytail-debt | /ponytail-debt |
Harvest shortcut: comments into a tracked ledger. |
| ponytail-gain | /ponytail-gain |
Measured-impact scoreboard: less code, less cost, more speed. |
| ponytail-help | /ponytail-help |
This card. |
In Codex CLI and the IDE extension, invoke skills with $ponytail:ponytail,
$ponytail:ponytail-review, or $ponytail:ponytail-help. Claude Code and OpenCode use the
slash-command forms above (OpenCode ships all six as slash commands).
Deactivate
Say "stop ponytail" or "normal mode". Resume anytime with /ponytail.
/ponytail off also works.
Band (Claude Code)
/ponytail band hides the band above the prompt, the same command brings it back.
/ponytail band on and /ponytail band off set it directly. The level stays.
/ponytail band import adds your past Claude Code sessions (cost, agent time, tokens) to the board.
Configure Default Mode
Default mode = full, auto-active every session. Change it:
Environment variable (highest priority):
export PONYTAIL_DEFAULT_MODE=ultra
Config file (~/.config/ponytail/config.json, Windows: %APPDATA%\ponytail\config.json):
{ "defaultMode": "lite" }
Set "off" to disable auto-activation on session start, activate manually
with /ponytail when wanted.
Resolution: env var > config file > full.
Update
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.
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.
More
Full docs + examples: https://github.com/DietrichGebert/ponytail
Version History
-
09c434a
Current 2026-10-18 22:14
新增 Claude Code 'band' 功能说明，支持隐藏/显示提示栏上方信息条，并引入 /ponytail band import 命令以导入过往会话数据至记分板。更新了默认模式的配置优先级说明。
- 40e50d9 2026-07-05 15:19
