view-cost-metrics

Use this skill to display current session cost metrics without creating a commit.

MANDATORY only activate this skill when the user invokes it directly (/view-cost-metrics) OR asks about current session costs.

Follow the workflow steps EXACTLY.

---

Skill Workflow Checklist

- [ ] 0. Prerequisites
- [ ] 1. Resolve SessionID
- [ ] 2. Fetch cost data
- [ ] 3. Display costs

---

Skill Context

SKILL_BASE_DIR: ${CLAUDE_SKILL_DIR}

⛔ VERSION CHECK: If SKILL_BASE_DIR above shows literal ${CLAUDE_SKILL_DIR} instead of a real path, halt: "This skill requires Claude Code 2.1.69 or higher."

Node.js Check: !node "${CLAUDE_SKILL_DIR}/../../lib/check-node-version.js"

⛔ HALT if Node.js Check shows ERROR.

Dependencies: !node "${CLAUDE_SKILL_DIR}/../../lib/check-dependencies.js" "${CLAUDE_SKILL_DIR}/../.."

Workflow Rules & Guardrails

MANDATORY: FOLLOW THESE RULES FOR THE ENTIRE WORKFLOW.

A. Narration Control

⚠️ SILENCE PROTOCOL Only narrate steps with a STEP_DESCRIPTION field. Execute all other steps and tool calls silently - no explanatory text.

B. JSON Response Protocol

All script outputs return JSON. Extract fields and store in variables.

---

Skill Workflow Instructions

0. Prerequisites

SKILL_NAME: view-cost-metrics

MODE: Determine from $ARGUMENTS: if it contains "cumulative" or "cum" → cumulative; otherwise → incremental (default, also matches "incremental" or "inc")

SKILL_CONFIG: !node "${CLAUDE_SKILL_DIR}/../../lib/check-skill-config.js" "./.claude/settings.plugins.view-cost-metrics.json"

Configuration Routing:

• If SKILL_CONFIG = ✓ Configuration found → Proceed to Step 1a (Load Configuration)
• If SKILL_CONFIG = NOT_CONFIGURED → Skip Step 1a, proceed to Step 1b (Create Configuration)

1. Resolve SessionID

1a. Load existing configuration

→ Configuration exists. Proceed to Step 2. → (The script reads the config file directly via --config flag.)