| name | piggy-help |
| description | Quick-reference card for all piggy modes, skills, and commands. One-shot display, not a persistent mode. Trigger: /piggy-help, "piggy help", "what piggy commands", "how do I use piggy".
|
Piggy 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 | /piggy lite | Build what's asked, name the lazier alternative in one line. |
| Full | /piggy | The ladder enforced: YAGNI → stdlib → native → one line → minimum. Default. |
| Ultra | /piggy ultra | YAGNI extremist. Deletion before addition. Challenges requirements before building. |
Level sticks until changed or session end.
Skills
| Skill | Trigger | What it does |
|---|
| piggy | /piggy | Lazy mode itself. Simplest solution that works. |
| piggy-review | /piggy-review | Over-engineering review: L42: yagni: factory, one product. Inline. |
| piggy-audit | /piggy-audit | Whole-repo scan — ranked list of what to delete or simplify. |
| piggy-debt | /piggy-debt | Harvests piggy: comments into a tracked ledger. |
| piggy-explain | /piggy-explain | Why a simplification was chosen over the elaborate version. |
| piggy-score | /piggy-score | Complexity score 1-10, with before/after. |
| piggy-compare | /piggy-compare | Lazy vs verbose version, side by side. |
| piggy-test | /piggy-test | The minimal runnable test for the lazy solution. |
| piggy-gain | /piggy-gain | Measured-impact scoreboard: less code, less cost, more speed. |
| piggy-help | /piggy-help | This card. |
Codex uses @piggy, @piggy-review, and @piggy-help; Claude Code
and OpenCode use the slash-command forms above (OpenCode ships /piggy and
/piggy-review).
Deactivate
Say "stop piggy" or "normal mode". Resume anytime with /piggy.
/piggy off also works.
Configure Default Mode
Default mode = full, auto-active every session. Change it:
Environment variable (highest priority):
export PIGGY_DEFAULT_MODE=ultra
Config file (~/.config/piggy/config.json, Windows: %APPDATA%\piggy\config.json):
{ "defaultMode": "lite" }
Set "off" to disable auto-activation on session start, activate manually
with /piggy when wanted.
Resolution: env var > config file > full.
Update
Enable auto-update once: open /plugin, go to Marketplaces, pick piggy, Enable auto-update. Claude Code then pulls new versions at startup (run /reload-plugins when it prompts). Manual refresh: /plugin marketplace update piggy 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/adamyasingh-12/Piggy-
