self-improve
Self-Improve
Reflect on the current session, identify concrete improvements, present them for approval, then create todos and execute.
Step 1: Gather Context
Use what's already in the conversation — tool outputs, errors, subagent summaries, dev server logs, test results. You're in the session, so you have the context.
Only use the session-reader skill if you need to review a subagent's session that isn't summarized in the current conversation.
Step 2: Analyze Improvement Areas
Examine each area below. Skip areas with no findings — only report what's actionable.
| Area | What to Look For |
|---|---|
| Agent config | Could AGENTS.md instructions be clearer? Did the agent misunderstand something that better wording would prevent? |
| Subagent behavior | Did subagents struggle, go off-scope, or need repeated correction? Would better task descriptions or agent definitions help? |
| Agent definitions | Check ~/.pi/agent/agents/*.md — are model choices, skills, or system prompts optimal for what was observed? |
More from hazat/pi-config
learn-codebase
Discover project conventions and surface security concerns. Use when starting work in a new or unfamiliar project, when asked to "learn the codebase", "check project rules", "what are the conventions", "onboard to this project", or "anything shady in this codebase". Scans agent config files (.claude/, .cursor/, CLAUDE.md, etc.) and runs a security/smell sweep for hardcoded secrets, insecure patterns, suspicious dependencies, and dangerous configurations.
15skill-creator
Create new agent skills following the Agent Skills specification. Use when asked to "create a skill", "add a new skill", "write a skill", "make a skill", "build a skill", or scaffold a new skill with SKILL.md. Guides through requirements, planning, writing, registration, and verification.
3add-mcp-server
Add an MCP server to pi. Use when asked to "add mcp server", "configure mcp", "add mcp", "new mcp server", "setup mcp", "connect mcp server", or "register mcp server". Handles both global and project-local configurations.
2cmux
|
1session-reader
Efficiently read and analyze pi agent session JSONL files. Use when asked to "read a session", "review a session", "analyze a session", "what happened in this session", "load session", "parse session", "session history", "go through sessions", or given a .jsonl session file path.
1code-simplifier
Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when asked to "simplify code", "clean up code", "refactor for clarity", "improve readability", or review recently modified code for elegance. Focuses on project-specific best practices.
1