Claude
Skills
Sign in
Back

groove-utilities-task-doctor

Included with Lifetime
$97 forever

Check task backend health and connectivity.

Backend & APIs

What this skill does


# groove-utilities-task-doctor

## Outcome

All task backend health checks pass. User knows if the task backend is correctly configured, installed, and reachable.

## Acceptance Criteria

- Each check is reported with ✓ or ✗
- Each failure includes a specific remediation command
- Checks cover config, CLI installation, and reachability

## Checks (run in order)

1. `.groove/index.md` exists at git root
2. `tasks.backend` key is present and has a valid value (`beans`, `linear`, `github`, or `none`)
3. If `tasks.backend: none` — report no-op and exit (all green)
4. Backend CLI is installed:
   - `beans`: `beans version`
   - `linear`: `linear --version`
   - `github`: `gh --version`
5. Backend-specific config file exists:
   - `beans`: `.beans.yml` at git root
   - `linear`: auth token configured
   - `github`: `gh auth status`
6. Backend is reachable (lightweight read operation):
   - `beans`: `beans list --json` (or equivalent)
   - `linear`: list one issue
   - `github`: `gh issue list --limit 1`
7. `AGENTS.md` contains `<!-- groove:task:start -->` section (if `tasks: beans`)

## Remediation hints

| Failure | Remediation |
|---|---|
| `.groove/index.md` missing | `/groove-utilities-task-config` or `/groove config` |
| Backend not installed | `/groove-utilities-task-install` |
| `.beans.yml` missing | `/groove-utilities-task-install` (will scaffold) |
| Backend unreachable | Check auth / network, re-run `/groove-utilities-task-install` |
| `AGENTS.md` section missing | `/groove install` |

## Constraints

- Report all checks even if an early one fails — give the full picture
- Do not attempt to fix issues — report and suggest only
- If `tasks: none`, show one green line: "tasks: none — task commands disabled" and exit

Related in Backend & APIs