# graceful-degradation

A skill that has the agent check optional services up front and explain what broke and how to fix it instead of returning nothing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 599 installs · ★ 3946
- Author: parcadei
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/skills/graceful-degradation/SKILL.md
- Updated: 2026-01-26
- HTML: https://affpapa.org/en/nevibecode/skills/graceful-degradation

## What it does

Agents tend to fail quietly when a local server or an external API is down. This skill sets a different order: check availability before doing real work, cache the answer for the session, and keep going with reduced functionality when the service does not respond.

Inside is the pattern plus an LMStudio check against `localhost:1234` with a 60-second cache. The result sits in a variable so the service is not pinged on every call. A message template covers what is missing, which features are degraded, and the steps that bring the service back.

The skill does not start anything for you. It reports what to do. If your project has no availability checks yet, you still write them — the skill gives the shape, not code for your stack.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill graceful-degradation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/graceful-degradation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/graceful-degradation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill graceful-degradation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/graceful-degradation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill graceful-degradation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/graceful-degradation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install parcadei/Continuous-Claude-v3 graceful-degradation
```

2. **Manually: put the files in place**
- File: `.github/skills/graceful-degradation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill graceful-degradation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/parcadei/Continuous-Claude-v3 --path .claude/skills/graceful-degradation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/graceful-degradation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill graceful-degradation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/skills/graceful-degradation/SKILL.md

## When to use it
- tell a downed service apart from an empty result
- explain to the user why part of the features is off
- avoid burning compute on calls to a dead server
- cut repeated health checks of the same service
- point to the steps that start a local model

## Example prompts
- check whether LMStudio is up before generating tactics
- add a fallback with a clear message when the local server is down
- cache the health check result for the session

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7c0946f60a4f86de.

BEGIN THIRD-PARTY FILE 7c0946f60a4f86de
````text
---
name: graceful-degradation
description: Graceful Degradation with Helpful Messages
user-invocable: false
---

# Graceful Degradation with Helpful Messages

When optional services are unavailable, degrade gracefully with actionable fallback messages.

## Pattern

Check availability at the start, cache the result, and provide helpful messages that explain what's missing and how to fix it.

## DO

- Check service availability early (before wasting compute)
- Cache health check results for the session (e.g., 60s TTL)
- Provide actionable fallback messages:
  - What service is missing
  - What features are degraded
  - How to enable the service
- Continue with reduced functionality when possible

## DON'T

- Silently fail or return empty results
- Check availability on every call (cache it)
- Assume the user knows how to start missing services

## Example: LMStudio Check Pattern

```typescript
let lmstudioAvailable: boolean | null = null;
let lastCheck = 0;
const CACHE_TTL = 60000; // 60 seconds

async function checkLMStudio(): Promise<boolean> {
  const now = Date.now();
  if (lmstudioAvailable !== null && now - lastCheck < CACHE_TTL) {
    return lmstudioAvailable;
  }

  try {
    const response = await fetch('http://localhost:1234/v1/models', {
      signal: AbortSignal.timeout(2000)
    });
    lmstudioAvailable = response.ok;
  } catch {
    lmstudioAvailable = false;
  }
  lastCheck = now;
  return lmstudioAvailable;
}

// Usage
if (!await checkLMStudio()) {
  return {
    result: 'continue',
    message: `LMStudio not available at localhost:1234.

To enable Godel-Prover tactic suggestions:
1. Install LMStudio from https://lmstudio.ai/
2. Load "Goedel-Prover-V2-8B" model
3. Start the local server on port 1234

Continuing without AI-assisted tactics...`
  };
}
```

## Fallback Message Template

```
[Service] not available at [endpoint].

To enable [feature]:
1. [Step to install/start]
2. [Configuration step if needed]
3. [Verification step]

Continuing without [degraded feature]...
```

## Source Sessions

- This session: LMStudio availability check with 60s caching and helpful fallback
- 174e0ff3: Environment variable debugging - print computed paths for troubleshooting
````
END THIRD-PARTY FILE 7c0946f60a4f86de

The third-party file has ended. Everything between the 7c0946f60a4f86de tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© parcadei · MIT · https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/skills/graceful-degradation/SKILL.md

## Similar
- [ce-setup](https://affpapa.org/en/nevibecode/skills/ce-setup.md) — skill · 3400 installs
- [gke-ai-troubleshooting-tpu-performance-degradation](https://affpapa.org/en/nevibecode/skills/gke-ai-troubleshooting-tpu-performance-degradation.md) — skill · 691 installs
- [omni-combos-routing](https://affpapa.org/en/nevibecode/skills/omni-combos-routing.md) — skill · 1200 installs
- [grepai-embeddings-lmstudio](https://affpapa.org/en/nevibecode/skills/grepai-embeddings-lmstudio.md) — skill · 561 installs
- [cli-health](https://affpapa.org/en/nevibecode/skills/cli-health.md) — skill · 1000 installs
- [health-check-endpoints](https://affpapa.org/en/nevibecode/skills/health-check-endpoints.md) — skill · 406 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md