Skills chatcrystal-debug-recall
🔍

chatcrystal-debug-recall

Safe

Recall Historical Debugging Solutions

Stop reinventing the wheel when debugging. This skill recalls historical fixes and root causes from your ChatCrystal memory, helping you diagnose failing tests, compiler errors, and runtime exceptions faster by leveraging past debugging sessions.

Supports: Claude Codex Code(CC)
🥉 74 Bronze
1

Download the skill ZIP

2

Upload in Claude

Go to Settings → Capabilities → Skills → Upload skill

3

Toggle on and start using

Test it

Using "chatcrystal-debug-recall". Use $chatcrystal-debug-recall to find similar TypeScript TS2322 errors we have fixed before.

Expected outcome:

Recalling from ChatCrystal memory... Found 3 relevant debugging sessions: 1) 'TS2322 error in src/api/auth.ts caused by missing generic type parameter on API response wrapper - fixed by adding type annotation', 2) 'TS2322 in user model due to union type incompatibility - resolved by using intersection type', 3) 'TS2322 when upgrading from TS 4.9 to 5.0 - caused by stricter type inference on conditional types, fixed by adding explicit type casts.

Using "chatcrystal-debug-recall". Use $chatcrystal-debug-recall with this error: NullPointerException at UserService.getProfile(UserService.java:42). Project: /myapp, Branch: main.

Expected outcome:

Found 2 relevant memories: 1) 'NPE at UserService.getProfile line 42 occurred when database connection pool was exhausted - fix was to increase pool size and add connection validation', 2) 'Same NPE location happened when user cache was not initialized on cold start - fixed by adding @PostConstruct initialization method'. Both memories suggest checking database connectivity and cache initialization.

Security Audit

Safe
v1 • 4/24/2026

All 21 static findings are false positives from markdown code blocks. The skill contains only documentation and an agent configuration file with no executable code, network operations, or security risks. The detected 'external_commands' patterns are markdown backtick syntax for JSON examples, not shell execution. The 'weak cryptographic algorithm' flags are false positives from documentation strings.

2
Files scanned
82
Lines analyzed
1
findings
1
Total audits
Low Risk Issues (1)
Static Analysis False Positives
The static scanner detected 21 potential issues including 'external_commands' and 'weak cryptographic algorithm' patterns. All are false positives: markdown code block backticks were misidentified as shell execution, and documentation strings containing words like 'upgrade' triggered cryptographic weakness alerts. This skill contains only documentation and configuration with no executable code.
Audited by: claude

Quality Score

38
Architecture
100
Maintainability
87
Content
50
Community
100
Security
91
Spec Compliance

What You Can Build

Debug Test Failures After Dependency Upgrade

Developer encounters failing tests after upgrading TypeScript from 4.9 to 5.2. The skill recalls previous debugging sessions where similar type errors occurred and identifies the root cause as changed type inference in the new TypeScript version, along with the specific fix applied.

Diagnose Runtime Exceptions in Production

DevOps engineer sees recurring NullReferenceException in production logs. The skill retrieves historical debugging sessions showing this exception occurs when the configuration cache is stale, with the exact fix to invalidate cache after config updates.

Resolve Build Breakage After Merge

Developer's build breaks after merging a feature branch with compiler errors about missing dependencies. The skill recalls a previous session where the same issue occurred and identifies that the merge strategy dropped a submodule reference, providing the fix command.

Try These Prompts

Basic Error Recall
Use $chatcrystal-debug-recall to find similar errors we have fixed before.
Structured Debugging Context
Use $chatcrystal-debug-recall with this error: [paste error message and stack trace]. The project directory is /path/to/project and the branch is feature/new-auth.
TypeScript Upgrade Diagnosis
Use $chatcrystal-debug-recall to find previous TypeScript upgrade issues. Error signature: TS2322 'Type is not assignable to type'. Affected files: src/types/user.ts and src/api/auth.ts.
Performance Regression Investigation
Use $chatcrystal-debug-recall to investigate this performance regression: API response time increased from 50ms to 500ms after the database migration commit. Check for similar performance issues we have debugged before.

Best Practices

  • Always provide error signatures like exception types, error codes, and log signatures when available to improve memory recall precision
  • Include project directory, branch, and affected file paths to help prioritize project-specific memories over global ones
  • Use recalled memories to inform your diagnosis but always verify the root cause in the current environment before applying fixes
  • Combine this skill with manual debugging steps rather than relying solely on historical solutions

Avoid

  • Applying recalled fixes without verifying they match the current error signature and environment context
  • Overfitting to a historical solution when the current failure has materially different symptoms or stack traces
  • Fabricating historical debugging data when ChatCrystal Core or MCP tools are unavailable in degraded mode
  • Calling the skill for non-debugging tasks like feature development or refactoring without clear error contexts

Frequently Asked Questions

What does this skill actually do?
This skill searches your ChatCrystal memory for historical debugging sessions similar to your current error, retrieving past root causes, fixes, and pitfalls to accelerate your diagnosis.
What information should I provide for best results?
Include error signatures like exception types, error codes, stack traces, affected file paths, project directory, branch name, and any tool versions that might be relevant to the failure.
What if no relevant memories are found?
The skill will report no matches and you should continue debugging normally using standard diagnostic approaches. Consider saving your debugging session afterward to build the memory base.
Can I rely entirely on recalled fixes without verification?
No. Always verify the root cause in your current environment before applying any historical fix, as error signatures may appear similar but have different underlying causes.
What is the difference between project and global memories?
Project memories are debugging sessions from your current codebase, while global memories aggregate learnings across all projects. The skill prioritizes project memories for relevance.
Does this skill work without ChatCrystal Core installed?
It operates in degraded mode without ChatCrystal Core, meaning it cannot recall historical memories and will inform you that long-term debug recall is unavailable.

Developer Details

File structure

📁 agents/

📄 openai.yaml

📄 SKILL.md