К основному содержанию
скилл CX Codex

groove-utilities-stats — скилл для Claude Code

Скилл groove-utilities-stats считает по памяти проекта, растёт ли рабочий цикл: уроки записаны и доведены до правил, серия ежедневных логов, открытые задачи и коммиты за период.

MIT 265 установок ★ 6 обновлён 2026-07-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add andreadellacorte/groove --skill groove-utilities-stats -a claude-code
Открыть на GitHub

Что делает groove-utilities-stats

Скилл читает папку .groove/memory/ и печатает метрики в чат. Три блока: воронка уроков (сколько записано и сколько помечено как graduated), соблюдение ритма (покрытие ежедневных логов за последние memory.review_days рабочих дней, текущая серия, свежесть недельных и месячных сводок, средняя оценка из signals.md) и скорость работы (открытые и закрытые задачи плюс коммиты за период).

Период задаётся аргументом: week, month или all. Есть bash-скрипт scripts/stats.sh — он отрабатывает без модели и быстрее. Если скрипт вернул 0, скилл просто отдаёт его вывод и останавливается. Код 3 значит, что локальные метрики уже посчитаны, а задачи из linear или github надо досчитать по шагам из SKILL.md.

Файлы скилл не трогает, только чтение. Но и считать ему нечего, пока в репозитории нет .groove/: скрипт выходит с кодом 1 и подсказывает установку. Счётчики задач появятся, только если в .groove/index.md в tasks.storage указан бэкенд — beans, linear или github; при none останутся одни коммиты.

Какие задачи решает

  • увидеть, сколько уроков записано и сколько из них стало правилами
  • поймать разрыв в серии ежедневных логов
  • посчитать открытые и закрытые задачи за период
  • проверить, не устарели ли недельные и месячные сводки
  • вывести среднюю оценку дней из signals.md

Примеры запросов агенту

  • Покажи дашборд groove за month
  • Сколько уроков мы записали и сколько довели до правил за неделю?
  • Выведи статистику за all: серия ежедневных логов, задачи и коммиты

Как установить groove-utilities-stats

1Через Skills CLI (Vercel)

npx skills add andreadellacorte/groove --skill groove-utilities-stats -a claude-code

2Вручную: положить файлы

~/.claude/skills/groove-utilities-stats/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/groove-utilities-stats/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о groove-utilities-stats

Как установить groove-utilities-stats в Claude Code?

Выполните npx skills add andreadellacorte/groove --skill groove-utilities-stats -a claude-code. Скилл встанет в ~/.claude/skills/groove-utilities-stats/SKILL.md.

Что показывает groove-utilities-stats?

Дашборд по трём блокам: воронка уроков с процентом доведённых до правил, соблюдение ритма (логи, серия, свежесть сводок, оценки) и скорость (задачи и коммиты). Всё выводится в разговор, файлы не меняются.

Почему в отчёте нет счётчиков задач?

Они считаются, только если в .groove/index.md в tasks.storage указан бэкенд: beans, linear или github. При none скилл показывает одни коммиты.

Исходный текст

SKILL.md · MIT
---
name: groove-utilities-stats
description: "Quantified compound-loop dashboard: lessons captured vs graduated, adherence streaks, and task velocity. Use to see whether the workflow is actually compounding."
license: MIT
allowed-tools: Read Glob Grep Bash(git:*) Bash(beans:*) Bash(gh:*) Bash(linear:*) Bash(jq:*) Bash(python3:*) Bash(chmod:*) AskUserQuestion
metadata:
  author: andreadellacorte
  bash: true
---

<!-- groove:managed — do not edit; changes will be overwritten by groove update -->

# groove-utilities-stats

Use $ARGUMENTS to specify the period: `week` (default), `month`, or `all`.

## Bash fast-path

This skill has a bash script at `scripts/stats.sh`. Run it directly for faster, model-free execution:

```bash
bash .agents/skills/groove-utilities-stats/scripts/stats.sh week
```

(Pass `week`, `month`, or `all` to match $ARGUMENTS.) If the script exits 0, report its stdout and stop — do not continue with the steps below. If it exits non-zero, continue with the markdown steps (exit 3 means it printed the local metrics but the `linear`/`github` task counts still need to be computed below; exit 1 means no `.groove/`).

## Outcome

A read-only dashboard is printed to the conversation quantifying compound-loop health for the period: the **compound funnel** (lessons captured vs graduated), **adherence** (daily-log coverage, streak, rollup freshness, ratings), and **velocity** (task open/closed, commits). No files are written. This answers "is the workflow compounding / am I keeping the rhythm" — for qualitative patterns, it points to `/groove-utilities-memory-retrospective`.

## Acceptance Criteria

- Compound funnel shown: lessons captured (total + in period), graduated (total + in period), graduation rate
- Adherence shown: daily-log coverage over the last `memory.review_days` business days, current streak, weekly/monthly rollup freshness, ratings count + average
- Velocity shown: task open/closed counts (if a task backend is configured) and commit count in the period
- Output goes to the conversation only; nothing is written
- Absent data sources are skipped with sensible "n/a"/"NA" placeholders rather than errors

## Steps

(Model fallback — the bash fast-path above does this deterministically. Reproduce the same output format.)

1. Memory path is always `.groove/memory/`. If `.groove/` is absent, stop with an install hint.

2. Read `.groove/index.md` frontmatter: `tasks.storage` (backend; legacy key `tasks.backend`) and `memory.review_days` (default 5).

3. Determine date range from $ARGUMENTS: `week` = last 7 days, `month` = last 30 days, `all` = everything. Call the start `<since>`.

4. **Compound funnel**:
   - Captured: count `## YYYY-MM-DD` dated entries across `.groove/memory/learned/*.md` (exclude `signals.md`) — total, and those with date ≥ `<since>`.
   - Graduated: count `[graduated YYYY-MM-DD]` markers across the same files — total, and those ≥ `<since>`.
   - Graduation rate = graduated_total / captured_total as a percentage (`n/a` if none captured).

5. **Adherence**:
   - Daily-log coverage: of the last `review_days` business days (Mon–Fri, ending today), how many have `.groove/memory/daily/YYYY-MM-DD.md`.
   - Streak: consecutive most-recent business days (back from today) that have a daily log; stop at the first gap.
   - Rollup freshness: `weekly` is `fresh` if a `.groove/memory/weekly/<ISO-year>-W<ISO-week>.md` exists for the current or previous week, else `stale`; `monthly` likewise for `.groove/memory/monthly/YYYY-MM.md`.
   - Ratings: parse `.groove/memory/learned/signals.md` table rows (`| YYYY-MM-DD | N/5 | note |`) with date ≥ `<since>`; report count and average (and a `▁▂▄▆█` sparkline if ≥ 3).

6. **Velocity**:
   - Commits: `git log --oneline --since=<since>` count.
   - Tasks, by `tasks.storage`:
     - `beans`: open = `beans list --json --no-status completed --no-status scrapped | jq length`; closed = `--status completed` + `--status scrapped`; best-effort open mistakes/promises = count of non-terminal children under the "Mistakes"/"Promises" epics.
     - `linear`: via the linear CLI/MCP — assigned issues grouped into open vs done.
     - `github`: `gh issue list --assignee @me --state all` grouped into open vs closed.
     - `none`: omit task counts (show commits only).

7. Print the dashboard in the **Output format** below.

## Output format

```
## Groove Stats — <period> (<start> to <today>)

### 🔁 Compound funnel
Lessons captured: <N> (<n> this <period>)   Graduated: <G> (<g> this <period>)
Graduation rate: <pct>

### 📿 Adherence
Daily logs: <x>/<review_days> business days   Streak: <s> days
Rollups: weekly <fresh|stale>, monthly <fresh|stale>
Ratings: <c> in period | avg <a>/5  <sparkline>

### 🚀 Velocity
Tasks: <open> open / <closed> closed   Commits: <k> in period
Open: <m> mistakes, <p> promises

_For qualitative patterns and learnings, run `/groove-utilities-memory-retrospective`._
```

## Constraints

- Read only — never write to any file (no memory, no AGENTS.md, no config).
- Skip any absent data source with a one-line `n/a`/`NA` rather than erroring; parse tables and dates defensively.
- Paths are hardcoded under `.groove/memory/` (not configurable), consistent with the rest of groove.
- This skill complements `/groove-utilities-memory-retrospective` (qualitative reflection) — do not duplicate its narrative; cross-link it.

© andreadellacorte · MIT · andreadellacorte/groove

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
caveman-stats JuliusBrussee Скилл caveman-stats выводит статистику токенов и активный режим сессии или направляет к штатным отчётам хоста. Полезен для контроля расхода токенов вывода и кэша. CX Codex +1 385 600установок metrics-dashboard phuryn Скилл metrics-dashboard для Claude Code проектирует дашборд метрик с North Star, input-, health- и бизнес-метриками. Помогает определить KPI, настроить product analytics и план мониторинга данных. CX Codex +1 3 200установок huawei-cloud-obs-stats huaweicloud Скилл huawei-cloud-obs-stats показывает бакеты Huawei Cloud OBS с объёмом и числом объектов, скачивание и число запросов с месяцем к месяцу. CX Codex +1 18 300установок working-on Garrick Aden-Buie (@gadenbuie) Скилл working-on назначает файл отслеживания источником правды для текущей задачи. Агент дописывает туда решения, находки и планы по ходу работы. CX Codex +1 571установок gsd-stats open-gsd Скилл gsd-stats для Claude Code показывает прогресс и метрики проекта. Вызывается по запросу свести фазы, планы, требования и историю Git в одну сводку. CX Codex +1 574установок resume davila7 Команда resume восстанавливает контекст оркестровки задач в Claude Code после разрыва сессии или переключения между проектами. CX Codex +1 622установок

Из того же набора42

Весь набор →
groove-work-doc Скилл groove-work-doc для Claude Code создаёт справочный файл об устройстве компонента или концепции в кодовой базе для передачи контекста людям и будущим агентам. CX Codex +1 519установок groove-admin-cursor-hooks Скилл groove-admin-cursor-hooks ставит нативные хуки groove в .cursor/hooks.json: перезагрузка контекста после компакции, напоминания в конце дня, буфер git-коммитов и защита служебных путей. CX Codex +1 519установок groove-utilities-memory-retrospective Скилл groove-utilities-memory-retrospective для Claude Code собирает по .groove/memory/ ретроспективу: оценивает динамику сессий, находит повторяющиеся сбои и выводит сводку в чат. Для недельных разборов. CX Codex +1 517установок groove-utilities-memory-graduate Скилл groove-utilities-memory-graduate переносит устойчивый вывод из .groove/memory/learned/ в AGENTS.md, чтобы правило действовало в каждой будущей сессии без запуска prime. CX Codex +1 511установок groove-groovebook-review Скилл groove-groovebook-review находит открытые пуллреквесты с обучающими материалами в репозитории groovebook, показывает их diff и отправляет отзыв через GitHub CLI. CX Codex +1 508установок groove-groovebook-publish Скилл groove-groovebook-publish для Claude Code публикует рабочий инсайт в groovebook через pull request. Запускается после groove-work-compound, если наработкой стоит поделиться. CX Codex +1 507установок groove-utilities-onboard Скилл groove-utilities-onboard генерирует GROOVE.md в корне проекта, чтобы новый контрибьютор понял, какие команды запускать и где лежат логи. Полезно, когда в команду приходит человек на groove-проект. CX Codex +1 506установок groove-admin-claude-statusline Скилл groove-admin-claude-statusline ставит в Claude однострочную статусную строку с моделью, веткой git, расходом токенов и лимитами. Полезна, когда нужно видеть контекст сессии без лишних команд. CX Codex +1 502установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой