skills.rest
project-ax
project-axOFFICIAL
Explore all skills by this author →
GitHub

ax-debug

Debug and develop the AX personal AI agent across multiple development tiers.

5|2|Updated Feb 8, 2026
Search Tags:#development#debugging#kubernetes#e2e-testing#chat-ui#ipc#ax-agent
One-click install
npx skills add https://github.com/project-ax/ax-legacy --skill ax-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ax-debug
Source: https://github.com/project-ax/ax-legacy/tree/main/.claude/skills/ax-debug
Command: npx skills add https://github.com/project-ax/ax-legacy --skill ax-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

The ax-debug skill unit provides a suite of tools for debugging and developing the AX personal AI agent, addressing issues ranging from UI development to backend bugs and IPC problems.

Core Features & Use Cases

  • Chat UI Dev Loop: Offers a quick and visual development iteration for the chat UI using Vite HMR, local AX server, and Playwright MCP.
  • E2E Test Infrastructure: Provides automated testing with mock providers and a kind cluster for backend bugs.
  • Kind Cluster Dev Loop: Allows development with real k8s pods and host volume mounts for production parity pod behavior.
  • Local Process Harnesses: Facilitates IPC debugging without k8s overhead using HTTP IPC or NATS IPC.
  • Use Case: When encountering bugs in the AX chat UI or backend, the skill unit offers a structured approach to debug and reproduce issues using various development tiers.

Quick Start

Run the chat UI development loop in real LLM mode with the following command:

npm run dev:chat start

Frequently Asked Questions about ax-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug IPC communication issues in a Kubernetes AI agent?▼

Debug IPC issues in a Kubernetes AI agent using local process harnesses to test HTTP IPC or NATS IPC directly. This bypasses k8s overhead to isolate sandbox, host, and agent communication pipeline failures efficiently.

What is the best way to iterate on chat UI development for an AI agent?▼

Iterate on chat UI development using a dev loop with Vite HMR, a local AX server, and Playwright MCP. This provides quick, visual development iterations for identifying and fixing UI bugs.

How can I reproduce backend bugs with production parity in a Kubernetes environment?▼

Reproduce backend bugs with production parity using a Kind cluster dev loop. This allows development with real k8s pods and host volume mounts to mirror production pod behavior accurately.

Does the E2E test infrastructure support automated testing for backend bugs?▼

Yes, E2E test infrastructure supports automated testing for backend bugs by utilizing mock providers and a Kind cluster. This setup isolates and validates backend issues without requiring full production deployments.

Why do workspace release failures occur and how can I troubleshoot them?▼

Workspace release failures can stem from k8s-related issues or communication pipeline breakdowns. Troubleshoot them by leveraging multiple debugging tiers, including local process harnesses and Kind cluster dev loops.

Related Skills

Explore More Software Engineering Skills→
project-axproject-ax
5

ax-host

Orchestrate AX platform server actions, IPC, and request lifecycles.

Official
Advanced
thktthkt
11

e2e

Generate Playwright E2E tests and documentation through guided browser interactions.

Community
Intermediate
djscrew1738djscrew1738

kubernetes

Set up and manage local Kubernetes clusters with KIND for development and testing.

Community
Intermediate
zzafergokzzafergok
1

playwright-skill

Automate end-to-end browser testing for web applications using Playwright.

Community
Advanced