Profile My skills Saved Collections Edit profile Submit a skill

← all publishers

hathach

@hathach source repo

23 published skills

  1. ▌
    Pvs · hathach bundle
    Use when running PVS-Studio static analysis (SAST + MISRA C:2023 / C++:2008) on TinyUSB for a given board. Builds the examples with an exported compile_commands.json, runs pvs-studio-analyzer against .PVS-Studio/.pvsconfig, and emits readable + SARIF output.
    0
    installs
  2. ▌
    Cowork · hathach bundle
    Cowork with the other coding agent headless, in this worktree, through its own CLI - Claude drives `codex exec`, Codex drives `claude -p` - with resumed sessions, lanes, so context carries across requests. Hand it a bounded task, ask a question or a review, one request in flight per lane and lanes in parallel, and let a human follow its reasoning with `tail`. The coworker edits and commits locally; push, PRs and comments stay with the human.
    0
    installs
  3. ▌
    Herdr Peer · hathach bundle
    Cowork with the coding-agent session in the neighbouring Herdr pane, in either direction between Claude and Codex, sharing one checkout. Hand a bounded task to the peer and take the result back, ask it a question or for a review, or tell it what you are doing while you both work in parallel. The peer edits and commits locally; push, PRs and comments stay with the human. Interactive only; schema'd, unattended jobs belong in a project's one-shot runner, if it has one. Requires HERDR_ENV=1.
    0
    installs
  4. ▌
    Download Doc · hathach bundle
    Enumerate, download, and import vendor hardware documentation — datasheets, reference manuals, errata, programming/user manuals, application notes — into the Calibre library at ~/Documents/calibre-library, and refresh local copies when the vendor has published a newer revision. Use this whenever the user wants a datasheet or reference manual for a chip, asks to update/check/audit their documentation library, mentions ST/STM32 or NXP/i.MX/LPC/Kinetis/MCX documents, or wants to bulk-fetch a vendor's docs — even if they never say "Calibre".
    0
    installs
  5. ▌
    Simplify Gate · hathach bundle
    Show, switch on or switch off agentrc's simplify gate (the Codex YAGNI challenge that runs when a Claude Code session stops) for the current repository and all of its worktrees. `status` prints the state with the effective model and effort, `on` takes `--model`/`--effort` overrides, bare `/simplify-gate` or `help` prints the usage.
    0
    installs
  6. ▌
    Hil · hathach
    Use when running TinyUSB Hardware-in-the-Loop (HIL) tests on physical boards, when a HIL run fails, hangs, reports a board locked, or produces a report you need to interpret, or when copying firmware to a test rig (ci.lan, hifiphile/tusb, or a dev PC). For board/probe health scans ("pool check") use the hil-pool-check skill instead.
    0
    installs
  7. ▌
    Rtt · hathach bundle
    Use when you need console or printf I/O, TU_LOG capture, or a raw byte channel over a debug probe on real hardware — the board has no UART wired or its probe no VCOM, a LOGGER=rtt build needs reading or writing, "RTT Control Block not found", an RTT server won't come up or drops output, JLinkRTTLogger/JLinkRTTClient/JLinkGDBServer/openocd rtt misbehave, or another workflow (HIL console, SystemView capture) needs RTT stood up on a J-Link, ST-Link, CMSIS-DAP or WCH-Link probe.
    0
    installs
  8. ▌
    Pre Pr · hathach
    Use before opening or updating a TinyUSB PR — derives affected boards from the branch diff, runs the full-check workflow (software validation + optional HIL on the rig), and summarizes a ship/no-ship verdict.
    0
    installs
  9. ▌
    Usbmon · hathach bundle
    Use when capturing, analyzing, or debugging USB bus traffic on a link where a Linux PC is the host (TinyUSB in device role) — enumeration failures, STALLed control transfers, missing/short bulk or interrupt transfers, isochronous/audio dropouts, or descriptor problems. Captures host-side URBs with usbmon + tshark into a Wireshark pcapng and decodes them. Not applicable when TinyUSB is the host — no URBs traverse the PC (use usb-sniffer / target-debug). Use it whenever you need to see what the Linux host actually exchanged with a device on real hardware.
    0
    installs
  10. ▌
    Usbtest · hathach
    Use when running, debugging, or porting the Linux usbtest/testusb battery (examples/device/usbtest, cafe:4010) — device "did not bind", SET_CONFIGURATION fails, a case fails with errno 110/32/5/71, toggle-clear/halt/unlink/iso failures, iso packets dropped, or a new MCU/DCD needs the full 30/30 sign-off. Needs a Linux PC as the link's host driving TinyUSB in device role — it exercises the DCD, not the TinyUSB host stack.
    0
    installs
  11. ▌
    Read Doc · hathach bundle
    Use when you need authoritative hardware/protocol facts from a primary source rather than model memory — an MCU/peripheral datasheet, reference manual (RM/TRM), errata, pinout, register/bitfield layout, memory map, schematic, or the USB spec — before answering register/electrical/timing/protocol questions from training knowledge or the web; or when the user asks to read/open/look up a manual, datasheet, book, or PDF/EPUB from their Calibre library. Requires a local Calibre library at ~/Documents/calibre-library; no-ops if absent.
    0
    installs
  12. ▌
    Build Doc · hathach
    Use when building, previewing, or testing the TinyUSB Sphinx docs locally (docs/ → HTML), chasing Sphinx warnings, understanding how example READMEs get into the docs, or regenerating the auto-generated reference files after adding a board, a dependency, or a HIL rig board (boards.rst, dependencies.rst, hil_boards.md, BoardPresets.json, CMakePresets.json).
    0
    installs
  13. ▌
    Code Size · hathach
    Use when comparing TinyUSB code size between a base ref (master by default) and the current branch to evaluate the size impact of changes. Three granularities — single example on one board (with optional bloaty), all examples on one board, or all examples across CI families combined.
    0
    installs
  14. ▌
    Etm Trace · hathach bundle
    Use when you need instruction-level execution data from real hardware via a SEGGER J-Trace — cycle-accurate hot-function profiling, on-target code coverage, or raw instruction history (e.g. what ran right before a fault/hang) — beyond what logs, GDB, or DWT PC-sampling can answer. Covers unattended (headless) capture and analysis on ETM-capable TinyUSB boards.
    0
    installs
  15. ▌
    Peer Agent · hathach bundle
    Use when you want to ask a peer, collab with a peer, or otherwise reach another coding-agent session running beside you in the same worktree — to review a diff or design, challenge a claim before you act on it, or investigate something and report back. Works in either direction between agents. Read-only — the peer may look, run and report, but not edit, commit or post. Interactive only; schema'd one-shot jobs belong in `.claude/codex-agent.py`. Requires HERDR_ENV=1.
    0
    installs
  16. ▌
    Usb Sniffer · hathach
    Use when you need wire-level USB evidence that host-side capture can't provide — a device that never enumerates (usbmon shows nothing or only Submits), suspected NAK storms/STALL/babble/bad handshakes, bus-reset or enumeration timing, split-transaction issues, a usbmon-vs-device-log disagreement the wire must arbitrate, or any link where TinyUSB is the host (no Linux PC host to run usbmon on). Captures LS/FS/HS packets (PIDs, tokens, handshakes, SE0/line states) with the ataradov usb-sniffer hardware into Wireshark pcapng.
    0
    installs
  17. ▌
    Make Release · hathach
    Use when cutting a new TinyUSB release — version bump, regenerated files, the per-release changelog, and validation before the maintainer commits and tags.
    0
    installs
  18. ▌
    Target Debug · hathach
    target-debug — target-side capture & debugging on the HIL rig
    0
    installs
  19. ▌
    Hil Pool Check · hathach
    Use when asked for a pool check or board/probe health scan on a TinyUSB HIL rig, when probes or boards are offline or fail to flash, after rig maintenance, reboot, or re-cabling, or before starting a HIL test campaign.
    0
    installs
  20. ▌
    Update Sponsor · hathach bundle
    Use when a GitHub sponsor joins, upgrades, cancels, or switches between public and private; when the README sponsor sections are stale or show "be the first!" despite active sponsors; or when new issues, PRs, or discussions still need sponsor, priority, or Adafruit triage labels.
    0
    installs
  21. ▌
    Esp Target Debug · hathach
    Use when debugging TinyUSB firmware on Espressif boards (ESP32-S3/P4 on the rig — dcd_dwc2 examples, idf.py builds) with the chips' built-in USB-Serial-JTAG — attach/halt/backtrace, breakpoints, FreeRTOS task lists, console capture — or when JTAG "could not find or open device", the 303a:1001 port vanishes, or the S3's debug port turns into the TinyUSB device.
    0
    installs
  22. ▌
    Usb Kernel Debug · hathach bundle
    usb-kernel-debug — Linux kernel dynamic debug for USB
    0
    installs
  23. ▌
    Usb Kernel Recover · hathach bundle
    Use when a USB device or fixture on a HIL rig's Linux host (ci.lan, hifiphile/tusb, a bench PC) is wedged, not enumerating, or when processes touching USB (testusb, JLinkExe, uhubctl, openocd, libusb tools) hang in D state. Linux-host side only — a bus owned by a TinyUSB host is out of reach.
    0
    installs