# Chatcrystal Debug Recall

> Recall ChatCrystal memories for debugging tasks involving failing tests, compiler errors, runtime exceptions, dependency issues, environment breakage, or performance regressions. Use when historical root causes, fixes, or pitfalls may accelerate diagnosis before proposing a fix.

- **Type:** Skill
- **Install:** `agentstack add skill-zengliangyi-chatcrystal-chatcrystal-debug-recall`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ZengLiangYi](https://agentstack.voostack.com/s/zengliangyi)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [ZengLiangYi](https://github.com/ZengLiangYi)
- **Source:** https://github.com/ZengLiangYi/ChatCrystal/tree/main/skills/chatcrystal-debug-recall
- **Website:** https://zengliangyi.github.io/ChatCrystal/

## Install

```sh
agentstack add skill-zengliangyi-chatcrystal-chatcrystal-debug-recall
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ChatCrystal Debug Recall

Use this skill when the task is clearly about diagnosis or debugging. Keep the skill thin and let ChatCrystal Core handle retrieval.

## Workflow

1. Trigger when the task includes failing tests, compiler errors, runtime exceptions, broken dependencies, environment problems, or performance regressions.
2. If `recall_for_task` is available, call it before proposing a fix with:
   - `mode: "debug"`
   - `task.goal`: the concrete debugging objective
   - `task.task_kind: "debug"`
   - `task.project_dir` and `task.cwd` when known
   - `task.branch` when known
   - `task.related_files` or `task.files_touched` when known
   - `task.error_signatures` populated with the most useful identifiers available
3. Prefer concrete signals such as:
   - failing test names
   - exception classes
   - error codes
   - log signatures
   - package or tool versions when they materially affect the failure
4. Prioritize returned memories that explain root cause, remediation, or known pitfalls.
5. Use recalled memories to sharpen diagnosis, not to skip verification in the current environment.

## Example MCP Input

Use this shape when calling `recall_for_task` for debugging:

```json
{
  "mode": "debug",
  "task": {
    "goal": "Diagnose failing build after TypeScript upgrade",
    "task_kind": "debug",
    "project_dir": "/path/to/project",
    "cwd": "/path/to/project",
    "branch": "upgrade/typescript",
    "related_files": [
      "server/src/cli/mcp/server.ts",
      "tsconfig.base.json"
    ],
    "error_signatures": [
      "TS2322",
      "Type is not assignable"
    ],
    "source_agent": "codex"
  },
  "options": {
    "project_limit": 5,
    "global_limit": 3,
    "include_relations": true
  }
}
```

## Full Mode

Full mode requires ChatCrystal Core plus MCP access to `recall_for_task`.

- Keep `project_memories` primary and `global_memories` secondary.
- If the response includes warnings or `no-matches`, continue debugging normally.
- Do not overfit to a recalled fix when the current failure signature diverges materially.

## Degraded Mode

If ChatCrystal Core or the MCP tool is unavailable:

- Continue the debugging task without blocking.
- State briefly that long-term debug recall is unavailable.
- Do not fabricate historical failures, causes, or fixes.
- Do not turn installation commands into automatic skill steps.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ZengLiangYi](https://github.com/ZengLiangYi)
- **Source:** [ZengLiangYi/ChatCrystal](https://github.com/ZengLiangYi/ChatCrystal)
- **License:** Apache-2.0
- **Homepage:** https://zengliangyi.github.io/ChatCrystal/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zengliangyi-chatcrystal-chatcrystal-debug-recall
- Seller: https://agentstack.voostack.com/s/zengliangyi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.