Agent skill

jtag-swd-debug

Deep integration with JTAG/SWD debug probes for hardware-level debugging and flash programming

View SKILL.md on GitHub Repository
Stars 514
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/embedded-systems/skills/jtag-swd-debug

SKILL.md

JTAG/SWD Debug Skill

Overview

This skill provides deep integration with JTAG/SWD debug probes for hardware-level debugging, flash programming, and real-time firmware analysis. It enables direct hardware interaction through industry-standard debug interfaces.

Capabilities

Debug Probe Operations

  • Execute OpenOCD, J-Link, and ST-LINK commands
  • Configure debug probe connections and interfaces
  • Manage multiple debug probe types and adapters
  • Handle transport protocols (JTAG, SWD, cJTAG)

Memory Operations

  • Read/write memory-mapped registers
  • Direct memory inspection and modification
  • Real-time memory watch and modification
  • Flash programming and verification
  • Memory dump and analysis

Debugging Features

  • Set hardware breakpoints and watchpoints
  • Core state inspection (registers, stack, PC)
  • Single-step execution control
  • Fault handler analysis and debugging
  • Call stack unwinding

Trace and Output

  • Semihosting input/output support
  • SWO trace output configuration
  • ITM stimulus port configuration
  • Real-time trace buffer analysis

Target Processes

  • hardware-bring-up.js - Initial board validation and debug setup
  • bootloader-implementation.js - Bootloader debugging and flash operations
  • device-driver-development.js - Driver debugging with hardware access
  • field-diagnostics.js - Field debugging and analysis

Dependencies

  • OpenOCD (Open On-Chip Debugger)
  • J-Link software (Segger)
  • ST-LINK utilities (STMicroelectronics)
  • Debug probe hardware (J-Link, ST-LINK, CMSIS-DAP)

Usage Context

This skill is invoked when tasks require:

  • Direct hardware debugging through JTAG/SWD
  • Flash memory programming operations
  • Low-level register and memory inspection
  • Fault analysis and crash debugging
  • Hardware breakpoint management

Configuration

yaml
debug_probe:
  type: jlink | stlink | openocd | cmsis-dap
  interface: swd | jtag
  speed: 4000  # kHz
  target: cortex-m4 | cortex-m7 | etc.

Example Operations

Flash Programming

bash
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg \
  -c "program firmware.elf verify reset exit"

Memory Read

bash
JLinkExe -device STM32F407VG -if SWD -speed 4000 \
  -CommanderScript read_memory.jlink

Register Inspection

bash
openocd -f board/stm32f4discovery.cfg \
  -c "init; halt; reg; resume; exit"

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

a5c-ai/babysitter

gsd-tools

Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).

514 31
Explore
a5c-ai/babysitter

model-profile-resolution

Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.

514 31
Explore
a5c-ai/babysitter

verification-suite

Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.

514 31
Explore
a5c-ai/babysitter

state-management

STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.

514 31
Explore
a5c-ai/babysitter

git-integration

Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.

514 31
Explore
a5c-ai/babysitter

frontmatter-parsing

YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.

514 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results