mcpField
G
groove-utilities-task-doctor

groove-utilities-task-doctor

github.com/andreadellacorteProductivity6551 installsUpdated 14w ago
Repository

About groove-utilities-task-doctor

A task-backend diagnostic skill for Groove projects. It checks configuration, CLI installation, backend authentication and reachability, then reports failures with remediation commands without changing anything.

Key features

  1. 01Checks Groove task configuration
  2. 02Verifies backend CLI installation
  3. 03Tests backend authentication and reachability
  4. 04Reports every check and remediation
  5. 05Does not modify the setup

Use cases

  1. 01Diagnosing a task backend before using task commands
  2. 02Finding missing configuration or CLI tools
  3. 03Checking backend access when task operations fail

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/andreadellacorte/groove --skill groove-utilities-task-doctor

After installing, type/groove-utilities-task-doctorin Claude Code to confirm it loaded.

Details

From the project README

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

FailureRemediation
.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 unreachableCheck 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

Comments

Markdown supported