Skip to content

donaldfilimon/abi / .agents/skills/backend-diagnostics

backend-diagnostics

Verified

Build the abi CLI and report GPU / accelerator / shader / MLIR backend status and the compute-backend matrix (CPU/GPU/NPU/TPU detection + dynamic selection). Use when asked about backend capabilities, why a backend shows accelerated=false, or to capture a hardware/dispatch report.

FileKindSize
SKILL.mdskill md1.5 KB
diag.shexecutablescript1.3 KB
---
name: backend-diagnostics
description: Build the abi CLI and report GPU / accelerator / shader / MLIR backend status and the compute-backend matrix (CPU/GPU/NPU/TPU detection + dynamic selection). Use when asked about backend capabilities, why a backend shows accelerated=false, or to capture a hardware/dispatch report.
---

# backend-diagnostics — capture abi's backend capability report

Driver: **`.agents/skills/backend-diagnostics/diag.sh`** (paths relative to repo root).
Read-only CLI capture — evidence is the `RESULT:` line + the backend tables.

## Run (agent path)
```bash
.agents/skills/backend-diagnostics/diag.sh
```
Builds the CLI, then captures `abi backends`, `abi wdbx compute info`, and
`abi wdbx gpu info`; asserts the markers `Compute Backends:` and
`compute backends`. Prints `RESULT: PASS` (exit 0) or a FAIL count.

Current Rust driver: captures all three backend reports and requires the
compute/GPU section markers. Capability rows remain distinct from execution.

## Gotchas
- The backend is **runtime-selected** — there is no `-Dgpu-backend` option.
- A compiled or available backend is not automatically initialized or executed.
  Read the reported state fields rather than inferring acceleration from the OS.
- For deeper analysis use the `gpu-backend-analyzer` subagent.

## Troubleshooting
| Symptom | Fix |
|---|---|
| `build` FAIL | `./tools/check.sh`. |
| missing `Compute Backends:` | CLI grammar drift — check `crates/abi-cli/src/backends.rs`. |
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall