known-errors

Diagnose ChatCut plugin tool failures and recommend safe recovery actions.

751|69|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/ChatCut-Inc/agent-plugin --skill known-errors
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: known-errors
Source: https://github.com/ChatCut-Inc/agent-plugin/tree/main/claude/skills/known-errors
Command: npx skills add https://github.com/ChatCut-Inc/agent-plugin --skill known-errors

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and resolve ChatCut plugin failures without repeating invalid operations, losing project state, or masking important access, import, generation, and rendering errors.

Core Features & Use Cases

  • Mutation Error Handling: Responds safely to overlap conflicts, locked tracks, stale identifiers, and validation failures.
  • Media and Generation Recovery: Guides supported import retries, upload timing, motion-graphic tool selection, and provider or policy failure handling.
  • Verification and Export Support: Distinguishes successful mutations from visual proof, uses appropriate verification workflows, and manages render-readiness issues.
  • Use Case: When a timeline update fails because an item overlaps another clip, use this Skill to inspect the current state, choose a valid track or sequencing strategy, and avoid forcing a destructive write.

Quick Start

Ask the known-errors skill to diagnose the latest ChatCut tool failure and recommend the safest next action using the current tool schema and returned error details.

Frequently Asked Questions about known-errors

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I recover from a ChatCut timeline mutation error without losing project state?

Recover from a timeline mutation error by inspecting the current project state, identifying overlap conflicts or locked tracks, and choosing a valid sequencing strategy. This prevents destructive writes and avoids repeating invalid operations.

Why does my video export fail and how can I diagnose the rendering error?

Video export failures occur due to render-readiness issues or verification mismatches. Diagnose the rendering error by distinguishing successful timeline mutations from visual proof, then apply the appropriate verification workflow to resolve the block.

How do I fix media import failures and upload timing errors in video editing workflows?

Fix media import failures by triggering supported import retries and correcting upload timing. Handle provider or policy failures by checking authentication status and applying motion-graphic tool selection before attempting recovery again.

Does this error handling approach work with both Codex and Claude Code hosts?

Yes, this error handling approach works across both Codex and Claude Code hosts. It uses supported host adapters and the active MCP tool schema to diagnose plugin failures and recommend safe recovery actions for your specific environment.

What should I do when a ChatCut motion graphics tool returns a generation failure?

When a motion graphics tool returns a generation failure, review the structured error response to identify provider or policy issues. Use the diagnostic workflow to adjust motion-graphic tool selection and safely retry remote asset generation.

Can I force a timeline update if a clip overlaps another clip during video editing?

No, avoid forcing a timeline update when a clip overlap error occurs. Inspect the current state, select a valid track or sequencing strategy, and apply safe recovery actions to prevent destructive writes and project state corruption.