🛠️
QualityTypeScript

AgentDeck Diagnostics

by puritysb

AgentDeck Diagnostics is a Quality skill for Claude Code, published by puritysb in AgentDeck.

219 stars42 forkson puritysb/AgentDeckAdded 2026/09/04+2% in starsRepository updated 2026/09/04
ai-agentsandroidclaude-codedeveloper-toolsesp32hardwareiotmonorepostream-deckswiftui
Install in seconds
Install AgentDeck Diagnostics
Copy AgentDeck Diagnostics into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/puritysb/AgentDeck/tree/master/.agents/skills/sdc-diagnose ~/.claude/skills/sdc-diagnose

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/puritysb/AgentDeck.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.agents/skills/sdc-diagnose/SKILL.md in puritysb/AgentDeck
Installs to
~/.claude/skills/sdc-diagnose
Collection
One of 5 skills cataloged from this repository
Category
Quality1557 skills

What AgentDeck Diagnostics does

AgentDeck Diagnostics collects bridge logs, checks for cursor desync, stale options, hook gaps, and state-machine regressions. Use it to diagnose AgentDeck Stream Deck and PTY synchronization issues, add focused tests, and verify fixes with pnpm.

AgentDeck Diagnostics is cataloged under Quality on DirSkills. AgentDeck Diagnostics comes from a repository tagged ai-agents, android, claude-code, developer-tools and esp32.

Documentation

README

AgentDeck Diagnostic Skill

Canonical diagnostic procedure for AgentDeck bridge synchronization issues between device displays and agent terminals (cursor desync, false idle, stale options, action dispatch races, hook ingestion gaps, state-machine regressions). This file is the single source of truth — .claude/skills/sdc-diagnose.md is a thin pointer to it.

Step 1: Collect Diagnostic Data

From the repo root, try the live bridge first:

cd /Users/puritysb/github/AgentDeck
agentdeck diag --tail 500 2>/dev/null || echo "Bridge not running — using journal files directly"

If the bridge isn't running, read journal/log files directly:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about AgentDeck Diagnostics

  • What else does puritysb publish alongside AgentDeck Diagnostics?

    AgentDeck Diagnostics is one of 5 skills that DirSkills catalogs from puritysb/AgentDeck, the repository it ships in. Its siblings there include AgentDeck Deploy, AgentDeck Workflows and ESP32 Heap Discipline. Each one is a separate skill with its own page in this directory, installs the same way AgentDeck Diagnostics does, and is maintained by puritysb in that same repository. The rest of the collection is listed on the puritysb/AgentDeck page.

  • How does AgentDeck Diagnostics compare to other Quality skills?

    AgentDeck Diagnostics ranks #1395 by stars among the 1557 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of AgentDeck Diagnostics against them. Open each page to compare what they document and how they install.