Chatcrystal Task Writeback
Productivitychatcrystal-task-writebackChatcrystal Task Writeback is an Agent Skill for productivity published in the aiskillstore/marketplace repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Write reusable ChatCrystal task memories after substantive work completes. Use when implementation or debugging produced a durable fix, pitfall, pattern, or decision worth preserving, and when the environment can either persist it through `write_task_memory` or emit a structured memory candidate for later save.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/aiskillstore/marketplace/blob/HEAD/skills/zengliangyi/chatcrystal-task-writeback/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/chatcrystal-task-writeback, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
ChatCrystal Task Writeback
Use this skill after meaningful work completes. Let ChatCrystal Core decide whether a memory should be skipped, merged, or created.
Workflow
- Trigger only after substantive work completes and the result produced reusable knowledge.
- Good candidates include:
- a durable fix
- a meaningful pitfall
- a reusable pattern
- an explicit engineering decision
- If
write_task_memoryis available and the runtime has a stable run or session key, call it with:mode: "auto"source_run_key: the stable run or session keytask.goal,task.task_kind,task.project_dir,task.cwd,task.branchtask.source_agentwhen knownmemory.summary: concise and durable, not chattymemory.outcome_type: one ofpitfall,fix,pattern,decisionmemory.root_cause,memory.resolution,memory.error_signatures,memory.files_touched,memory.tagswhen relevant
- Use
mode: "manual"only for an explicit manual save flow, never as a silent fallback for automatic writeback. - Default to project-scoped knowledge. Only use global scope for clearly cross-project knowledge and only in an explicit manual save flow.
- Report the persistence result accurately:
createdmergedskipped
Example MCP Input
Use this shape when calling write_task_memory after a completed task with a stable run key:
{
"mode": "auto",
"source_run_key": "agent-session-or-run-id",
"scope": "project",
"task": {
"goal": "Fix MCP recall schema validation",
"task_kind": "debug",
"project_dir": "/path/to/project",
"cwd": "/path/to/project",
"branch": "fix/mcp-recall-schema",
"files_touched": [
"server/src/services/memory/schemas.ts",
"server/src/cli/mcp/server.ts"
],
"error_signatures": [
"invalid_type",
"recall_for_task schema mismatch"
],
"source_agent": "codex"
},
"memory": {
"summary": "MCP tool schemas must stay aligned with memory service request shapes; mismatches surface as validation failures before tool execution.",
"outcome_type": "fix",
"root_cause": "The MCP tool input shape diverged from the service schema.",
"resolution": "Reused the shared request shape in the MCP server registration.",
"files_touched": [
"server/src/services/memory/schemas.ts",
"server/src/cli/mcp/server.ts"
],
"tags": [
"mcp",
"memory-loop",
"schema"
]
}
}
Full Mode
Full mode requires ChatCrystal Core plus MCP access to write_task_memory.
- Do not reimplement skip or merge logic in the skill.
- Trust Core to decide whether the memory should be skipped, merged, or created.
- If the tool reports
skipped, keep the task result but do not force persistence.
Degraded Mode
If ChatCrystal Core or the MCP tool is unavailable, or if no stable run key exists for automatic writeback:
- Do not claim that the memory was saved.
- Emit a structured memory candidate in the response for later save.
- Keep the candidate aligned with the
write_task_memory.memorypayload shape so it can be reused later. - Do not instruct the runtime to auto-install ChatCrystal Core as part of the skill flow.