Skills
.Work. You
Rest

diagnose-generation-failure

Official

Diagnose and fix SDK generation failures fast.

Software Engineering#troubleshooting#OpenAPI#diagnose#lint#overlays#SDK-generation
Authorspeakeasy-api
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps you diagnose the root cause when SDK generation fails, enabling rapid triage and resolution.

Core Features & Use Cases

  • Automated troubleshooting: Run lint, categorize issues, and determine fix strategies like overlays or spec edits.
  • Guided decision framework: Provides a structured path for when to apply overlays, request API changes, or adjust design decisions.
  • Use Case: When a generated SDK does not align with the live API, use this Skill to identify whether the problem is in the spec, the generator, or the target language.

Quick Start

Run the diagnose-generation-failure workflow on the failing spec and follow the recommended steps to identify root causes and propose fixes.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: diagnose-generation-failure
Download link: https://github.com/speakeasy-api/skills/archive/main.zip#diagnose-generation-failure

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.