My custom agent configuration — skills, extensions, and themes.
Custom tools and commands that extend the agent's capabilities.
| Extension | Description |
|---|---|
| adr | /adr command to analyze session for architecture decisions and record them as MADR files |
| evaluate-test-harness | /evaluate-test-harness command to analyze a project's test suite against 19 testing categories |
| handoff.ts | /handoff command to transfer context to a new focused session with a generated prompt |
| insights.ts | /insights command for interactive exploration of session insights |
| interactive-form | Tabbed form UI for gathering multiple user inputs |
| notify.ts | Desktop notification via OSC 777 when the agent finishes and is waiting for input |
| refine-plan.ts | /refine-plan command to interrogate a plan until every ambiguity is resolved |
| review.ts | /review command for code review with multiple modes (PR, branch, uncommitted, commit) |
| statusline.ts | Minimal statusline showing active tool, context usage, git branch, and model |
Task-specific instructions that guide the agent for particular workflows.
| Skill | Description |
|---|---|
| adr | Write Architecture Decision Records for significant design choices |
| code-review | Git diff analysis for complexity, tests, docs, and dependencies |
| commit | Conventional Commits-style commit messages |
| context7 | Fetch up-to-date library documentation from Context7 |
| frontend-design | Design and implement distinctive frontend interfaces |
| git | Git best practices: atomic commits, conventional format, clean history |
| github | GitHub CLI (gh) for issues, PRs, CI runs, and API queries |
| improve-codebase-architecture | Find architectural improvement opportunities and deepen shallow modules |
| mermaid-diagrams | Render Mermaid diagrams as Unicode art |
| planning | Create detailed implementation plans with checkpoints |
| playwright-cli | Browser automation for web testing, screenshots, and data extraction |
| update-changelog | Update changelogs with changes between releases |
| web-search | Web search using Jina Search API |
Custom color schemes for the pi agent TUI.
| Theme | Description |
|---|---|
| catppuccin.json | Catppuccin color scheme |
| challenger-deep.json | Challenger Deep color scheme |
| dracula.json | Dracula color scheme |
| gruvbox-dark.json | Gruvbox Dark color scheme |
| night-owl.json | Night Owl color scheme |
| rose-pine.json | Rosé Pine color scheme |
To use these configurations, symlink or copy the contents to ~/.pi/agent/:
# Backup existing config
mv ~/.pi/agent ~/.pi/agent.bak
# Symlink this repo
ln -s /path/to/agent-kun/pi-agent ~/.pi/agentOr selectively copy specific skills/extensions/themes.
Some skills require API keys (optional but recommended for higher rate limits):
CONTEXT7_API_KEY- For context7 skillJINA_API_KEY- For web-search skill