What should I do if an Auto-Claude build is stuck?

The skill guides you to check for a PAUSE file in the spec directory, inspect the build-progress.txt log, or provide human input via HUMAN_INPUT.md to unstick the agent.

How do I fix Python version mismatch errors in Auto-Claude?

This skill identifies if you are below the required Python 3.12+ and provides specific commands for macOS, Ubuntu, and Windows to install the correct version and recreate your virtual environment.

How do I clear corrupted memory embeddings?

The skill provides a specific procedure to remove the ~/.auto-claude/memories/embeddings directory, allowing the system to re-index and resolve dimension mismatch errors.

How can I resolve 'Invalid OAuth token' errors?

You can use the 'claude setup-token' command and then update your .env file with the new token as detailed in the skill's authentication recovery section.

Auto-Claude Troubleshooting & Debugging

Name: Auto-Claude Troubleshooting & Debugging
Author: adaptationio

byadaptationio

Developer Tools

Diagnoses and resolves installation, authentication, and build errors within the Auto-Claude environment.

About

This skill serves as a comprehensive diagnostic engine for the Auto-Claude agent framework, providing Claude with the necessary context to identify and fix common technical hurdles. It covers everything from Python and Node.js environment mismatches to complex OAuth authentication issues and git worktree conflicts. By utilizing this skill, users can quickly recover from stuck builds, resolve memory system corruption in Graphiti, and optimize agent performance through verbose logging and configuration tuning, ensuring that automated coding workflows remain uninterrupted.

Key Features

0 GitHub stars
Automated system requirement and dependency verification
Stuck build recovery and manual intervention workflows
Advanced performance tuning and API rate limit management
OAuth token and subscription troubleshooting procedures
Memory system and embedding database repair guides

Use Cases

Fixing authentication loops where Claude Code fails to recognize valid OAuth tokens
Resolving environment-specific installation failures like node-gyp or Python version mismatches
Recovering from workspace corruption such as existing git worktrees or merge conflicts

About

Key Features

0 GitHub stars
Automated system requirement and dependency verification
Stuck build recovery and manual intervention workflows
Advanced performance tuning and API rate limit management
OAuth token and subscription troubleshooting procedures
Memory system and embedding database repair guides

Use Cases

Fixing authentication loops where Claude Code fails to recognize valid OAuth tokens
Resolving environment-specific installation failures like node-gyp or Python version mismatches
Recovering from workspace corruption such as existing git worktrees or merge conflicts