Improve Expertise Skill

Improve Expertise

Run the self-improve workflow on an agent expert's expertise file to maintain accuracy.

Arguments

$1: Domain name (required, e.g., "database", "websocket")
$2: Check git diff flag (optional, "true" or "false", default: "true")

Instructions

You are running the self-improve workflow to sync an expert's mental model with the actual codebase.

Step 1: Parse Arguments

Extract:

Domain name from $1 (required)
Check git diff flag from $2 (optional, default: true)

If no domain provided, STOP and ask for domain name.

Step 2: Validate Expert Exists

Check if expert directory exists using Glob:

Glob: .claude/commands/experts/{$1}/expertise.yaml

If not found:

STOP and report "Expert not found. Use /tac:create-expert to create it first."
List available experts using: Glob: .claude/commands/experts/*

Step 3: Spawn Self-Improver Agent

Delegate to the self-improver agent with:

Domain name
Path to expertise file: .claude/commands/experts/{domain}/expertise.yaml
Check git diff flag

The agent will:

Check git diff (if flag is true)
Read current expertise
Validate against codebase
Identify discrepancies
Update expertise file
Enforce line limits
Validate output

Step 4: Report Results

Display the self-improve report:

## Self-Improve Complete: {domain}

### Changes Made

- [List of changes]

### Expertise Health

| Metric | Value |
| --- | --- |
| Line count | X/1000 |
| Files validated | X/X exist |
| Functions verified | X/X accurate |

### Recommendations

- [Any recommendations for manual review]

Quick Usage

# Sync after making changes (checks git diff)
/tac:improve-expertise database true

# Full rescan without git diff check
/tac:improve-expertise database false

# Default behavior (checks git diff)
/tac:improve-expertise websocket

When to Run

| Trigger | Command | | --- | --- | | After any build/fix work | /tac:improve-expertise {domain} true | | Periodic maintenance | /tac:improve-expertise {domain} false | | Suspect drift | /tac:improve-expertise {domain} false | | Before major planning | /tac:improve-expertise {domain} false |

Notes

This is the LEARN step of Act-Learn-Reuse
Run after every ACT (build, fix, modify) step
Mental model is NOT source of truth - this syncs it with code
Expertise file must stay under 1000 lines

Last Updated: 2025-12-15

Agent Skills: Improve Expertise

Install this agent skill to your local

Skill Files