tusk-insightslisted
Install: claude install-skill gioe/tusk
# Tusk Insights
Two capabilities for inspecting the task database:
1. **HTML Dashboard** — generate and open a self-contained HTML view of per-task token counts, cost, and session metrics.
2. **Audit + Q&A** — read-only health audit followed by interactive recommendations. **Phase 1** runs a non-interactive audit across 6 categories, presenting findings as a structured report. **Phase 2** opens an interactive Q&A session for deeper exploration.
If the user invoked this skill asking for the dashboard (e.g. "/tusk-insights dashboard", "open the dashboard", "show me the HTML view"), run the **HTML Dashboard** flow below. Otherwise, run the **Audit + Q&A** flow.
---
## HTML Dashboard
Run:
```bash
tusk dashboard
```
Then confirm to the user that the dashboard has been generated and opened in their browser.
---
## Audit + Q&A
### Phase 1: Audit
#### Step 1: Load Config
```bash
tusk config
```
Parse the JSON. Note which arrays are empty — empty means no validation is configured for that column:
- `domains` → `[]` means skip domain orphan checks
- `agents` → `{}` means skip agent orphan checks
Hold onto the config values for Phase 2 (recommendations).
#### Step 2: Pre-Check Counts
Run the built-in audit command to get counts for all six categories:
```bash
tusk audit
```
This returns JSON with `config_fitness`, `task_hygiene`, `dependency_health`, `session_gaps`, `criteria_gaps`, and `scoring_gaps` counts. All six keys are always present even when the count is zer