Graceful Degradation

When you're building tools that depend on optional services like LMStudio or local APIs, this gives you a pattern for failing gracefully instead of cryptically. It shows you how to check availability upfront with a 60 second cache, then return actionable messages that tell users exactly what's missing and how to fix it. The fallback template is the real value here: explain what service failed, list the specific steps to enable it, then continue with reduced functionality. It's the difference between "connection failed" and actually helping someone get unstuck. Works well when you're building CLI tools or development workflows where optional integrations shouldn't break the whole experience.

skills.sh installs: 601
GitHub stars: 3.9K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add parcadei/continuous-claude-v3 --skill graceful-degradation --agent claude-code

Installs into .claude/skills of the current project.

Files

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

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;
  }

SKILL.md on GitHub