# Groove Utilities Task Doctor

> Check task backend health and connectivity.

Check task backend health and connectivity.

- Page: https://ss33.ai/skills/andreadellacorte/groove-utilities-task-doctor-30394504285
- Publisher: andreadellacorte
- Category: [AI & Agents](https://ss33.ai/skills/category/ai-and-agents-y6jz7i) › [Tool & MCP integration](https://ss33.ai/skills/category/ai-and-agents-y6jz7i/tool-and-mcp-integration-fgfs8e)
- License: MIT
- Source: https://github.com/andreadellacorte/groove/blob/2494f0dabc68403b67cb6ca8575291d4c8c81a42/skills/groove-utilities-task-doctor/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/andreadellacorte/groove-utilities-task-doctor-30394504285

# 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