Skip to main content

ag-skill v1.0.1 Released

· 3 min read

ag-skill v1.0.1 is now live: Release v1.0.1

What's in this release​

Local Telemetry — observe, stats, dashboard​

v1.0.1 ships four new commands for recording and reviewing skill/agent run telemetry entirely locally. No external service, no account — everything lives in .ag-skill/telemetry/runs.jsonl inside your repository.

Because ag-skill runs outside Copilot/Claude/Cursor, token usage is self-reported by calling one of the observe sub-commands after your agent finishes.

ag-skill observe​

Display the most recent telemetry records as a Rich table.

ag-skill observe
ag-skill observe --tail 50
ag-skill observe -n 0 # show all

ag-skill observe record​

Append one record to the telemetry log. Tokens can be supplied as exact counts, estimated from piped stdin, a response file, or inline text (1 token ≈ 4 chars).

# Pipe agent output directly — tokens auto-estimated
my-agent "design DDD aggregates" | ag-skill observe record --skill ddd-aggregate-design --agent ag-architect --model gpt-5 --response-stdin --duration-ms 8200

# Exact token counts from the platform's usage API
ag-skill observe record --skill ddd-aggregate-design --agent ag-architect --model gpt-4o --prompt-tokens 3200 --completion-tokens 1800 --duration-ms 12400

ag-skill observe from-copilot​

Auto-read the latest VS Code Copilot Chat transcript — no pasting required. Tokens are estimated (Copilot Chat transcripts do not include usage data).

ag-skill observe from-copilot --skill ddd-aggregate-design --agent ag-architect --model gpt-4o --duration-ms 12400

Omit --skill to preview without recording.

ag-skill observe from-claude​

Auto-read the latest Claude Code session and record with exact token counts, including cache hits (cache_creation_input_tokens and cache_read_input_tokens).

ag-skill observe from-claude --skill ddd-aggregate-design --duration-ms 18500

ag-skill resolves the session from ~/.claude/projects/<encoded-cwd>/. Omit --skill to preview without recording.

ag-skill observe estimate-tokens​

Sanity-check a token estimate for any text before recording.

ag-skill observe estimate-tokens "Design DDD aggregates for the order service..."
# → 11 estimated tokens (47 characters)

ag-skill stats​

Print aggregated statistics — totals, per-skill breakdown, and per-model breakdown — as Rich tables.

ag-skill stats

ag-skill dashboard​

Generate a self-contained HTML dashboard with summary cards, per-skill and per-model breakdowns, and a full run log (newest first). No internet connection or JavaScript required.

ag-skill dashboard
start .ag-skill/dashboard.html

# Custom output path
ag-skill dashboard --output reports/dash.html

Internal changes​

  • Added src/ag_skill/commands/observe.py — observe Typer sub-app with record, estimate-tokens, from-copilot, and from-claude sub-commands.
  • Added src/ag_skill/commands/stats.py — stats command.
  • Added src/ag_skill/commands/dashboard.py — dashboard command.
  • Added src/ag_skill/core/telemetry.py — low-level JSONL read/write helpers.
  • Added src/ag_skill/core/readers.py — transcript parsers for VS Code Copilot Chat (.jsonl under workspaceStorage) and Claude Code (~/.claude/projects/).
  • Added tests/test_readers.py — unit and CLI integration tests for the new readers and observe sub-commands.

Release artifacts​

  • Wheel: ag_skill-1.0.1-py3-none-any.whl
  • Source distribution: ag_skill-1.0.1.tar.gz

Both artifacts are attached to the GitHub release.