How do I install the Skill Cost skill?

Run npx skillmds@latest add dvcrn/skill-cost in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Cost safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Cost?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Cost free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skill Cost?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Cost by dvcrn — Agent Skill

Name: Skill Cost
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

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.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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 ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report

Last 7 days:

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

Since a specific date:

bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --since 2026-03-01

JSON output:

bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --format json

Top skills by cost:

bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh ranking

Detail for a specific skill:

bash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh detail poe-connector

Compare two skills:

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

Scans OpenClaw session JSONL files at ~/.openclaw/agents/*/sessions/
Parses assistant messages for tool calls and token usage
Attributes token usage to skills by matching bash command paths and tool names
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)

---name: skill-costdescription: 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 Cost — USE BASH TOOL**You MUST use the `bash` or `shell` tool to run these commands. No other method works.**## CommandsPer-skill cost report:```bashbash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report```Last 7 days:```bashbash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --days 7```Since a specific date:```bashbash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --since 2026-03-01```JSON output:```bashbash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh report --format json```Top skills by cost:```bashbash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh ranking```Detail for a specific skill:```bashbash ~/.openclaw/workspace/skills/skill-cost/skill-cost.sh detail poe-connector```Compare two skills:```bashbash ~/.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 Works1. Scans OpenClaw session JSONL files at `~/.openclaw/agents/*/sessions/`2. Parses assistant messages for tool calls and token usage3. Attributes token usage to skills by matching bash command paths and tool names4. 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)

Frequently asked questions