← All skills
debug-dashboard
75 / 100 · Review before installing
Check before installing. Some of what it can do is expected: a productivity skill usually connects to your mail, calendar or notes.
By BlackBeltTechnology/pi-agent-dashboard (GitHub) · productivity · 348 stars · scanned at commit e78b4c2
Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries. Routes UI/visual issues to the browser skill. Use when the server seems hung, a pi session won't connect, tests fail mysteriously, the dashboard shows a blank page, restart loops, port conflicts, or any "why isn't X working" question.
Works with any agent that supports SKILL.md skills.
What this skill can do
Downloads and installs other software
The author does not mention this.
Found in 20 places.
Show 17 more
- .pi/skills/debug-dashboard/SKILL.md, line 22
npx tsx ./scripts/tail-server-log.ts # last 50 lines of current run - .pi/skills/debug-dashboard/SKILL.md, line 23
npx tsx ./scripts/list-sessions.ts # connected pi sessions via REST - .pi/skills/debug-dashboard/SKILL.md, line 26
> Scripts are TypeScript (cross-platform). All invocations use `npx tsx` so they work on Linux, macOS, and Windows. `tsx` is already a project dep. - .pi/skills/debug-dashboard/SKILL.md, line 53
npx tsx ./scripts/run-tests-triage.ts # all tests, tee to OS tmpdir, summarize failures - .pi/skills/debug-dashboard/SKILL.md, line 54
npx tsx ./scripts/run-tests-triage.ts packages/server # restrict to one package's vitest - .pi/skills/debug-dashboard/SKILL.md, line 55
npx tsx ./scripts/run-tests-triage.ts -t 'my test' # by test name - .pi/skills/debug-dashboard/references/log-locations.md, line 84
Where `npx tsx ./scripts/run-tests-triage.ts` captures `npm test` output. Lives until next reboot or until you re-run. On Windows, the path is `%TEMP%\pi-test.l - .pi/skills/debug-dashboard/references/log-locations.md, line 112
| Why are my changes not appearing? | Are you in dev mode? `npx tsx ./scripts/health-probe.ts` | - .pi/skills/debug-dashboard/references/test-failure-triage.md, line 47
npx vitest run path/to/file.test.ts - .pi/skills/debug-dashboard/references/test-failure-triage.md, line 52
npx vitest run -t 'my test name' - .pi/skills/debug-dashboard/references/test-failure-triage.md, line 59
npx vitest -w packages/server # one package - .pi/skills/debug-dashboard/references/test-failure-triage.md, line 93
Running `npx vitest run` (or a workspace test) directly ABORTS with: - .pi/skills/debug-dashboard/references/test-failure-triage.md, line 99
HOME=$(mktemp -d) npx vitest run packages/automation-plugin - .pi/skills/debug-dashboard/references/ui-debug.md, line 34
npx tsx ./scripts/health-probe.ts # this skill - .pi/skills/debug-dashboard/scripts/run-tests-triage.ts, line 34
label: `npx vitest run -t '${rest}'`, - .pi/skills/debug-dashboard/scripts/run-tests-triage.ts, line 40
return { cmd: 'npx', cmdArgs: ['vitest', 'run', first], label: `npx vitest run ${first}` }; - .pi/skills/debug-dashboard/scripts/run-tests-triage.ts.AGENTS.md, line 3
Runs `npm test` (or scoped variant), tees output to `${tmpdir}/pi-test.log`, prints FAIL-marker summary. Flags: none = `npm test`; `-t '<name>` = `npx vitest ru
Runs commands on your computer
The author does not mention this.
Found in 4 places.
Show 1 more
Connects to the internet
The author does not mention this. Expected for a productivity skill.
Found in 4 places.
Show 1 more
Safer alternatives
Low-risk skills in the same category (productivity) that look related. Check that one does what you need.
Install
Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.
if [ -e ~/.agents/skills/'debug-dashboard' ] || [ -L ~/.agents/skills/'debug-dashboard' ]; then echo 'A skill folder named debug-dashboard already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/BlackBeltTechnology/pi-agent-dashboard' "$d" && git -C "$d" checkout --quiet 'e78b4c2c0474a8ab04941e76942e5a5b9d92c2d6' -- '.pi/skills/debug-dashboard' && mkdir -p ~/.agents/skills && cp -R "$d"/'.pi/skills/debug-dashboard' ~/.agents/skills/'debug-dashboard' && rm -rf "$d"; fi
Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'debug-dashboard' ~/.claude/skills/'debug-dashboard' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.
Badge for your README
The badge for BlackBeltTechnology/pi-agent-dashboard shows the score of its lowest-scoring skill.
[](https://zalavijaysinh.github.io/skilltrust/repos/BlackBeltTechnology/pi-agent-dashboard/)
Score history
| Date | Version | Score |
|---|
| 2026-11-13 | e78b4c2 | 75 |
| 2026-11-07 | 3cf8afe | 100 |