Recovery guide

Troubleshoot Yammerknit

Start from what you can observe. Preserve the source before changing a record.

Codex reports available, not installed

  1. Run codex plugin add yammerknit@personal.
  2. Run codex plugin list.
  3. Confirm the marketplace entry points to ./plugins/yammerknit.
  4. Confirm that folder contains .codex-plugin/plugin.json.
  5. Start a new task after the status becomes installed, enabled.

Claude cannot find the skill

Confirm the installed path ends in yammerknit/SKILL.md. An extra directory level prevents discovery. Restart the host when the skills directory was created after the current session began.

Python or the helper script is unavailable

Core inline artifact creation can continue without Python. Persistence, validation, revision, inspection, and subtitle acquisition require Python and the complete skill folder. Run commands from that folder or use its absolute scripts/yammerknit_tool.py path; do not invoke a similarly named script from an old extracted kit.

yt-dlp is not available

Install the optional dependency with python -m pip install -U yt-dlp. If installation is unavailable, provide transcript text directly. Core Yammerknit creation does not otherwise depend on yt-dlp.

No VTT subtitles were available

The video may have no accessible human or automatic subtitles. Provide an authorized transcript or another source document. The helper does not fall back to downloading or transcribing audio.

The artifact fails validation

  1. Read the errors array in validation.json.
  2. Ask the agent to repair only those structural failures.
  3. Validate the complete artifact again.
  4. Have Giles inspect semantic clustering, source fidelity, bridge quality, and sigil intent.

A structural pass does not prove semantic quality.

Yammerknit refuses to overwrite a record

Keep the existing source and base artifact. Store the changed artifact as a revision, or create a distinct record when the source itself changed. The refusal is a custody safeguard.

A moved workspace contains stale absolute paths

Preserve the files. Regenerate the manifests with the current helper rather than editing source or artifact bytes. Version 0.1.0 produces relative internal links.