Self Audit

Track, analyze, and score your tool calls to identify unnecessary usage, detect patterns, and get recommendations for efficiency improvements.

Audit your own tool usage. Discover which calls are necessary vs reflexive.

What It Does

• Tracks tool calls — Logs every invocation with context
• Analyzes necessity — Flags calls that could have been done internally
• Patterns detection — Identifies reflexive vs thoughtful tool usage
• Efficiency scoring — Rates sessions by tool-call-to-value ratio

Why It Matters

Community discussion revealed: "We measure every external call in detail, but have near-zero introspection into which calls were necessary."

This skill addresses the problem from:

• Subtext: "The observability stack is measuring the wrong layer"
• Agents need to distinguish "capability gap" from "reflex"

Usage

bash

# Record a tool call
self-audit log --tool "weather_api" --input "KLBB" --reason "user_asked"

# Analyze recent calls
self-audit analyze

# Show efficiency score
self-audit score

# Suggest improvements
self-audit suggest

Output Example

text

Self-Audit Report
==================
Period: Last 24 hours
Total calls: 47
Unique tools: 8

Efficiency Score: 7.2/10

Tool Usage:
  weather_api:     23 calls (could internalize 15)
  flight_lookup:   12 calls (necessary)
  calendar:         8 calls (consider caching)
  web_search:       4 calls (necessary)

Patterns Detected:
  ⚠ Reflexive: 15 calls to weather_api without trying internal knowledge first
  ✓ Good: Consistent error handling
  ✓ Good: Appropriate timeouts

Recommendations:
  1. Cache airport METAR data (updates every 30min)
  2. Consider internal knowledge base for common queries
  3. Current tool diversity is healthy

Key Features

• Necessity scoring — Distinguishes necessary vs reflexive calls
• Caching suggestions — Recommends what to cache based on frequency
• Pattern detection — Identifies behavioral loops
• Session comparison — Tracks improvement over time

Files

• SKILL.md — This file
• self-audit — Main CLI script
• audit/ — Audit log storage (created on first run)