# Chatcrystal Task Recall

> Recall project-first and global-supplement ChatCrystal memories before substantive implementation, refactoring, migration, configuration, investigation, or optimization work. Use when the task is non-trivial, has repository or project context, and prior fixes, decisions, pitfalls, or reusable patterns may change the approach.

- **Type:** Skill
- **Install:** `agentstack add skill-zengliangyi-chatcrystal-chatcrystal-task-recall`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ZengLiangYi](https://agentstack.voostack.com/s/zengliangyi)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **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-task-recall
- **Website:** https://zengliangyi.github.io/ChatCrystal/

## Install

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

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

## About

# ChatCrystal Task Recall

Use this skill as a thin workflow on top of ChatCrystal Core. Do not invent a parallel memory system in the skill.

## Workflow

1. Decide whether the task is substantial enough to justify recall.
2. Trigger for non-trivial `implement`, `refactor`, `migration`, `config`, `investigate`, or `optimization` work.
3. Skip trivial edits, one-line answers, or purely conversational requests.
4. If `recall_for_task` is available, call it before substantive work with:
   - `mode: "task"`
   - `task.goal`: the concrete task objective
   - `task.task_kind`: the best matching task kind
   - `task.project_dir` and `task.cwd` when repository context exists
   - `task.branch` when known
   - `task.related_files` or `task.files_touched` when known
   - `task.source_agent` when the runtime has a stable value
5. Treat `project_memories` as primary context and `global_memories` as supplemental context.
6. Apply recalled pitfalls, patterns, and prior decisions before proposing or writing code.

## Example MCP Input

Use this shape when calling `recall_for_task` for implementation or investigation work:

```json
{
  "mode": "task",
  "task": {
    "goal": "Add a paginated notes export endpoint",
    "task_kind": "implement",
    "project_dir": "/path/to/project",
    "cwd": "/path/to/project",
    "branch": "feature/export-notes",
    "related_files": [
      "server/src/routes/notes.ts",
      "shared/types/index.ts"
    ],
    "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`.

- Prefer the current repository or workspace path so Core can derive `project_key`.
- Surface relevant warnings such as `no-project-key` or `no-matches`, but do not treat them as failures.
- If recall returns nothing useful, continue the task normally.

## Degraded Mode

If ChatCrystal Core or the MCP tool is unavailable:

- Continue the task without blocking.
- State briefly that long-term recall is unavailable in this environment.
- Do not claim that any memory was recalled.
- Do not instruct the runtime to auto-install ChatCrystal Core as part of the skill flow.

## 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-task-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%.