# Skill Cost

> Track per-skill token usage and costs from OpenClaw session logs. Use when user asks about skill-level spending, which skill costs the most, or wants a per-skill cost breakdown. IMPORTANT: This is a bash-tool skill. You MUST use the bash/shell tool to execute commands.

- Skill: `dvcrn/skill-cost` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add dvcrn/skill-cost`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/skill-cost/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/skill-cost

---


# Skill Cost — USE BASH TOOL

**You MUST use the `bash` or `shell` tool to run these commands. No other method works.**

## Commands

Per-skill cost report:
```bash
bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report
```

Last 7 days:
```bash
bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --days 7
```

Since a specific date:
```bash
bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --since 2026-03-01
```

JSON output:
```bash
bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --format json
```

Top skills by cost:
```bash
bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh ranking
```

Detail for a specific skill:
```bash
bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh detail poe-connector
```

Compare two skills:
```bash
bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh compare poe-connector web-search
```

## DO NOT

- Do NOT use `sessions_spawn` — it will fail
- Do NOT use browser — it will fail
- Do NOT use any approach other than `bash` tool — only bash works

## How It Works

1. Scans OpenClaw session JSONL files at `~/.openclaw/agents/*/sessions/`
2. Parses assistant messages for tool calls and token usage
3. Attributes token usage to skills by matching bash command paths and tool names
4. Aggregates and reports per-skill costs with model and daily breakdowns

## Notes

- No API keys required — reads directly from local session files
- No external Python dependencies (stdlib only)
- Skill attribution uses bash command paths and SKILL.md tool mappings
- Tokens for multi-skill messages are proportionally split across skills
- Usage not attributable to any skill is categorized as (built-in) or (conversation)