groove-utilities-stats — скилл для Claude Code
Скилл groove-utilities-stats считает по памяти проекта, растёт ли рабочий цикл: уроки записаны и доведены до правил, серия ежедневных логов, открытые задачи и коммиты за период.
MIT 265 установок ★ 6 обновлён 2026-07-24
npx skills add andreadellacorte/groove --skill groove-utilities-stats -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/groove-utilities-stats/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/groove-utilities-stats/
1Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-utilities-stats -a codex2Вручную: положить файлы
.agents/skills/groove-utilities-stats/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-utilities-stats -a cursor2Вручную: положить файлы
.cursor/skills/groove-utilities-stats/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install andreadellacorte/groove skills/groove-utilities-stats2Вручную: положить файлы
.github/skills/groove-utilities-stats/SKILL.md1Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-utilities-stats -a gemini-cli2Командой платформы
gemini skills install https://github.com/andreadellacorte/groove --path skills/groove-utilities-statsВручную: положить файлы
.devin/skills/groove-utilities-stats/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-utilities-stats -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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