OpenParable
Skip to content
← Back to skills

Chatcrystal Task Writeback

Productivity
chatcrystal-task-writeback

Chatcrystal 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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

  1. Trigger only after substantive work completes and the result produced reusable knowledge.
  2. Good candidates include:
    • a durable fix
    • a meaningful pitfall
    • a reusable pattern
    • an explicit engineering decision
  3. If write_task_memory is available and the runtime has a stable run or session key, call it with:
    • mode: "auto"
    • source_run_key: the stable run or session key
    • task.goal, task.task_kind, task.project_dir, task.cwd, task.branch
    • task.source_agent when known
    • memory.summary: concise and durable, not chatty
    • memory.outcome_type: one of pitfall, fix, pattern, decision
    • memory.root_cause, memory.resolution, memory.error_signatures, memory.files_touched, memory.tags when relevant
  4. Use mode: "manual" only for an explicit manual save flow, never as a silent fallback for automatic writeback.
  5. Default to project-scoped knowledge. Only use global scope for clearly cross-project knowledge and only in an explicit manual save flow.
  6. Report the persistence result accurately:
    • created
    • merged
    • skipped

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.memory payload shape so it can be reused later.
  • Do not instruct the runtime to auto-install ChatCrystal Core as part of the skill flow.