# Improve Expertise

> Run self-improve on an expert's mental model to sync with codebase. Use periodically to keep expertise files accurate. Use when this capability is needed.

- Skill: `tomevault-io/improve-expertise` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/improve-expertise`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/improve-expertise/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/improve-expertise

---


# 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:

```text
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:

1. Check git diff (if flag is true)
2. Read current expertise
3. Validate against codebase
4. Identify discrepancies
5. Update expertise file
6. Enforce line limits
7. Validate output

### Step 4: Report Results

Display the self-improve report:

```markdown
## 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

```bash
# 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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/melodic-software) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->