Agent skill
troubleshooting-bugs
Standard protocol for debugging and fixing issues across the stack. Use when encountering errors or unexpected behavior.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/troubleshooting-bugs
SKILL.md
Debugging and Troubleshooting
When to use this skill
- UI is not rendering as expected.
- Appwrite API calls are failing.
- Next.js build errors or hydration mismatches.
Protocol
- Check Browser Console: Look for hydration errors or JavaScript crashes.
- Check Network Tab: Inspect the request/response payload for Appwrite calls.
- Check Appwrite Console: View "Logs" and "Permissions" for the failing collection.
- Check Terminal: Look for
use serveror promise-related errors in the Next.js dev server.
Common Fixes
- Auth Error (401): User is not logged in or doesn't have permissions.
- Hydration Error: Ensure
useStateor browser-only APIs are wrapped inuseEffect. - Forbidden (403): Check Appwrite "Document Security" settings.
Instructions
- Log specifically: Use
console.error('[Appwrite Error]:', error)for clarity.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?