01-usage — скилл для Claude Code: расход токенов и установка
Скилл 01-usage отвечает, сколько токенов ушло за период или на одну задачу — по дням, моделям, агентам или тикетам, из локального отчёта aidd telemetry.
MIT ★ 571 обновлён 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-telemetry@aidd-frameworkЧто делает 01-usage
Скилл отвечает на вопрос про расход токенов: сколько ушло за период или на одну задачу. Сначала проверка — работает ли aidd telemetry --help. Нет CLI, нет и цифр.
Дальше вопрос раскладывается на период и одну ось: день, модель, агент, тикет или сессия. Остальное фиксируется фильтрами. Потом запускается aidd telemetry report --json, и скилл пересказывает цифры, отдельно называя то, чего в отчёте нет.
Считает он только по готовому отчёту: вход, выход, чтение кеша и запись в кеш держит раздельно, итог берёт из поля total, ничего не суммирует и не переводит в деньги. Сам сбор не включает. Если aidd не установлен или слишком старый, скилл скажет, что цифр нет, и назовёт @ai-driven-dev/cli — вот это и надо поставить или обновить.
Какие задачи решает
- узнать, сколько токенов ушло за неделю по дням
- найти модель или агента, которые съели больше всего
- посмотреть расход на конкретный тикет или сессию
- разложить одну задачу по инструментам и агентам
- сверить вход и выход с чтением кеша
Примеры запросов агенту
- Сколько токенов ушло за прошлую неделю по дням?
- Покажи расход по моделям за этот месяц.
- Сколько токенов потратила последняя сессия?
Как установить 01-usage
1Через маркетплейс плагинов
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-telemetry@aidd-frameworkКоманда ставит плагин aidd-telemetry целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-usage -a claude-code3Вручную: положить файлы
~/.claude/skills/01-usage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/01-usage/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-usage -a codex2Вручную: положить файлы
.agents/skills/01-usage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-usage -a cursor2Вручную: положить файлы
.cursor/skills/01-usage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-telemetry/skills/01-usage2Вручную: положить файлы
.github/skills/01-usage/SKILL.md1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-usage -a gemini-cli2Командой платформы
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-telemetry/skills/01-usageВручную: положить файлы
.devin/skills/01-usage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-usage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 01-usage
Как установить 01-usage в Claude Code?
Через маркетплейс плагинов: сначала /plugin marketplace add ai-driven-dev/framework, затем /plugin install aidd-telemetry@aidd-framework. Скилл приезжает вместе с плагином aidd-telemetry.
Что делает 01-usage?
Отвечает на вопросы про расход токенов по данным локальной телеметрии: разбирает вопрос на период и одну ось, запускает aidd telemetry report --json и называет цифры вместе с тем, что осталось неизвестным.
Что нужно, чтобы скилл заработал?
Рабочий aidd из @ai-driven-dev/cli и уже собранная телеметрия: скилл только читает отчёт, измерение он не включает. Если aidd telemetry --help падает, цифр не будет.
Исходный текст
SKILL.md · MIT
---
name: 01-usage
description: Answer what a period or one piece of work consumed in tokens, per day, model, agent, tool, task, ticket, session, repository or person, from the local measurement. Use when the user asks how many tokens were spent, where the effort went, or what a task or ticket consumed. Not for turning measurement on or off.
argument-hint: question | period
---
# Usage
```mermaid
flowchart TD
question([question]) --> probe{"aidd answers telemetry?"}
probe -->|"no"| absent([say it is missing, answer nothing])
probe -->|"yes"| frame
frame -->|"no axis fits"| refuse([say what the report cannot split by])
frame --> answer
answer -->|"refused or unknown version"| stop([say so])
answer --> told([figures, with what is unknown])
```
## Actions
Run the flow above. Read only the next action file.
| Action | Does |
| --- | --- |
| frame | map the question to a period, one axis and the filters it fixes, and name the command |
| answer | run it, read the JSON, and state the figures with what is unknown |
## Transversal rules
- Probe first. Run `aidd telemetry --help` before any action. When `aidd` is not found, or the command exits non-zero, stop and say plainly that `aidd` is missing or too old to report, name `@ai-driven-dev/cli` as what to install or update, and state that no figure is available. Never answer from memory, from the session, or from anything but the report.
- Every figure comes from `aidd telemetry report --json`. Never add, subtract, average, convert or estimate a number, and never turn tokens into money: the report holds counts only.
- Keep input, output, cache read and cache write apart. A total is the report's own `total`, not a sum made here.
- An unknown is unknown, never zero. Say so whenever the report shows one.
- Read only. Nothing here declares a task, turns measurement on, or changes any file.
© AI-Driven Dev · MIT · ai-driven-dev/framework