improve

Improve Skills, Capture Context & Knowledge

Analyze the current conversation to improve skills, fix codebase gaps, capture durable knowledge, and generate handoff prompts for skills managed outside this repository.

When to Use

Run /improve at the end of any session where:

• Skills were invoked and required manual fixes or workarounds
• You discovered better patterns or approaches mid-conversation
• A skill produced output that needed multiple iterations to get right
• Technical assumptions in a skill turned out to be wrong
• You learned something that would make a skill work better next time
• You hit a codebase gap (missing docs, tests, error handling, or config)
• You learned new organizational context (people, roles, vendor contacts, processes)

Context

• Current repo: !git rev-parse --show-toplevel 2>/dev/null | head -1
• Skills directory: !find agents/skills -maxdepth 2 -name SKILL.md 2>/dev/null | head -30
• Context directory exists: !ls context/knowledge/index.md 2>/dev/null | head -1
• Knowledge base index: !cat context/knowledge/index.md 2>/dev/null | head -30
• Context directory structure: !find context -type f 2>/dev/null | head -20
• Voice profile: !find . -maxdepth 3 -name 'voice-profile.md' -o -name 'VOICE.md' -o -name 'voice.md' 2>/dev/null | head -5
• Argus KB available: !command -v argus 2>/dev/null | head -1
• Argus KB index: !argus kb list 2>/dev/null | head -200
• Argus KB recent changes: !tail -30 ~/.dots/sys/kb-changes/changes.jsonl 2>/dev/null | head -30

Instructions

When /improve is invoked:

Step 0a: Load Argus KB Context (if available)

If the dynamic context above shows argus is on PATH and the KB index is non-empty, the Argus KB is the primary durable store. Load it before doing anything else.

See references/argus-kb.md for the full load procedure (which docs to read, MCP tool name fallbacks, search heuristics). Summary: always-load memory/user/ + memory/feedback/ (or rely on the SessionStart hook), then kb_search on session-relevant keywords and read top matches.