CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

terminal-recovery

Recover from failed terminal commands using evidence-driven diagnosis and bounded retries

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./resources/skills/agent/terminal-recovery/SKILL.md
SKILL.md
Quality
Evals
Security

When to Use

Use when a command fails, times out, produces incomplete output, or behaves differently from what the task requires.

Procedure

  1. Read the command, exit status, standard output, and standard error before choosing a response.
  2. Confirm the working directory, relevant files, executable availability, permissions, and environment assumptions with minimal read-only probes.
  3. Classify the failure as syntax, missing dependency, wrong path, permissions, resource pressure, timeout, service state, or task logic.
  4. Change one relevant condition and retry the narrowest command that can test the diagnosis.
  5. For a long-running command, use the returned session identifier to poll or provide input instead of launching duplicates.
  6. After recovery, run the original acceptance check and inspect the resulting files or service state.

Pitfalls

  • Do not rerun an unchanged failing command repeatedly.
  • Do not install packages or change global configuration before confirming they are missing and necessary.
  • Do not launch a second server or training job before checking for an existing process and port or device conflicts.
  • Do not treat partial output or a zero exit status as proof that the requested state was produced.

Verification

  • The diagnosed cause is supported by command output or environment state.
  • The corrected command exits as expected.
  • The requested artifact, process, or state passes an independent acceptance check.
Repository

odysseus-dev/odysseus

Path

resources/skills/agent/terminal-recovery/SKILL.md

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.