Skip to content

v0.22.0: the agent surface — usage-insight skill - #8

Open
lroolle wants to merge 1 commit into
feat/check-session-summaryfrom
feat/agent-surface
Open

v0.22.0: the agent surface — usage-insight skill#8
lroolle wants to merge 1 commit into
feat/check-session-summaryfrom
feat/agent-surface

Conversation

@lroolle

@lroolle lroolle commented Jul 29, 2026

Copy link
Copy Markdown
Member

Stacked on #7 (merge order: #6#7 → this; base is feat/check-session-summary).

What

skills/usage-insight/SKILL.md — teaches any Claude Code instance to read the statusline's state dir and answer usage questions conversationally. Three layers, one source of truth:

  1. Line 1 shows the numbers
  2. The advisor row says the one sentence that matters
  3. The skill carries the full conversation: "should I start a heavy task now?", "which account has headroom?", "what did I waste this week?", "when does Fable come back?"

Install: cp -r skills/usage-insight ~/.claude/skills/

The skill encodes the state-dir contract (docs/api/state-dir.md), the learned-forecast semantics (pct_per_window, weekday profile, predicted_end calibration), and the advisor's judgment rules — feasibility before advice, facts only while the ratio is unlearned, staleness said out loud, fresh siblings only. It runs the same report/check subcommands instead of re-mining, so the layers cannot disagree. It also carries the privacy posture: read-only against the state dir, quote numbers not emails/uuids.

Docs-only: no script changes, suite stays 334/334.

🤖 Generated with Claude Code

Three layers, one source of truth: line 1 shows the numbers, the
advisor row says the one sentence, and this skill carries the full
conversation — should I start a heavy task, which account has headroom,
what did I waste this week. It encodes the state-dir contract, the
learned-forecast semantics, and the advisor's judgment rules
(feasibility before advice, facts only while unlearned, staleness said
out loud), and runs the same report/check subcommands instead of
re-mining — so the layers cannot disagree.

Install: cp -r skills/usage-insight ~/.claude/skills/

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant