{"id":48789539,"url":"https://github.com/speakeasy-api/skills","last_synced_at":"2026-04-13T19:30:40.150Z","repository":{"id":334252160,"uuid":"1140642852","full_name":"speakeasy-api/skills","owner":"speakeasy-api","description":"Agent Skills for SDK generation and OpenAPI tooling with Speakeasy CLI","archived":false,"fork":false,"pushed_at":"2026-02-03T00:07:49.000Z","size":634,"stargazers_count":2,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-03T06:10:28.030Z","etag":null,"topics":["claude-code","openapi","sdks","skills"],"latest_commit_sha":null,"homepage":"https://www.speakeasy.com/docs","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/speakeasy-api.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-23T15:07:48.000Z","updated_at":"2026-01-27T17:57:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/speakeasy-api/skills","commit_stats":null,"previous_names":["speakeasy-api/agent-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/speakeasy-api/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speakeasy-api%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speakeasy-api%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speakeasy-api%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speakeasy-api%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/speakeasy-api","download_url":"https://codeload.github.com/speakeasy-api/skills/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speakeasy-api%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31768605,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T15:25:13.801Z","status":"ssl_error","status_checked_at":"2026-04-13T15:25:09.162Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","openapi","sdks","skills"],"created_at":"2026-04-13T19:30:38.115Z","updated_at":"2026-04-13T19:30:40.137Z","avatar_url":"https://github.com/speakeasy-api.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n \u003ca href=\"https://www.speakeasy.com/\" target=\"_blank\"\u003e\n  \u003cimg width=\"1500\" height=\"500\" alt=\"Speakeasy Agent Skills\" src=\"https://github.com/user-attachments/assets/7afc209b-3e03-46ea-a29c-50221f7aca4d\" /\u003e\n \u003c/a\u003e\n \u003cbr /\u003e\n \u003cbr /\u003e\n  \u003cdiv\u003e\n   \u003ca href=\"https://speakeasy.com/docs/create-client-sdks/\" target=\"_blank\"\u003e\u003cb\u003eDocs Quickstart\u003c/b\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;//\u0026nbsp;\u0026nbsp;\u003ca href=\"https://go.speakeasy.com/slack\" target=\"_blank\"\u003e\u003cb\u003eJoin us on Slack\u003c/b\u003e\u003c/a\u003e\n  \u003c/div\u003e\n \u003cbr /\u003e\n\n \u003cbr /\u003e\n\n[![LW24 participant](https://img.shields.io/badge/featured-LW24-8957E5.svg?style=flat-square\u0026labelColor=0D1117\u0026logo=data:image/svg%2bxml;base64,PHN2ZyB3aWR0aD0iMzYwIiBoZWlnaHQ9IjM2MCIgdmlld0JveD0iMCAwIDM2MCAzNjAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+IDxyZWN0IHdpZHRoPSI2MCIgaGVpZ2h0PSIzMDAiIGZpbGw9IndoaXRlIi8+IDxyZWN0IHg9IjYwIiB5PSIzMDAiIHdpZHRoPSIxMjAiIGhlaWdodD0iNjAiIGZpbGw9IndoaXRlIi8+IDxyZWN0IHg9IjI0MCIgeT0iMzAwIiB3aWR0aD0iNjAiIGhlaWdodD0iNjAiIGZpbGw9IndoaXRlIi8+IDxyZWN0IHg9IjMwMCIgd2lkdGg9IjYwIiBoZWlnaHQ9IjMwMCIgZmlsbD0id2hpdGUiLz4gPHJlY3QgeD0iMTgwIiB3aWR0aD0iNjAiIGhlaWdodD0iMzAwIiBmaWxsPSJ3aGl0ZSIvPiA8L3N2Zz4=)](https://launchweek.dev/lw/2024/mega#participants)\n  \n\u003c/div\u003e\n\n\u003chr /\u003e\n\u003cbr /\u003e\n\n# Speakeasy Agent Skills\n\nA collection of [Agent Skills](https://agentskills.io/) for SDK generation and OpenAPI tooling with the [Speakeasy CLI](https://speakeasy.com/).\n\n## Installation\n\n```bash\nnpx skills add speakeasy-api/skills\n```\n\n## Available Skills\n\n| Skill | Use When... |\n|-------|-------------|\n| `speakeasy:speakeasy-context` | **Start here** — Use `speakeasy agent context` for accurate CLI info instead of web search. Provides feedback via `speakeasy agent feedback` |\n| `speakeasy:sdk-tf-generation-best-practices` | **Progressive Disclosure** — Comprehensive guide to all Speakeasy SDK and Terraform generation capability and best practices. Routes to detailed guides for generation workflows, language-specific patterns, customization, testing, and OpenAPI spec management |\n| `speakeasy:start-new-sdk-project` | You have an OpenAPI spec and want to generate an SDK |\n| `speakeasy:diagnose-generation-failure` | SDK generation failed, seeing \"Step Failed: Workflow\" |\n| `speakeasy:writing-openapi-specs` | Authoring OpenAPI specs from scratch or improving existing ones |\n| `speakeasy:manage-openapi-overlays` | Creating, applying, or fixing specs with OpenAPI overlays |\n| `speakeasy:improve-sdk-naming` | SDK method names are ugly, wanting AI-powered or manual naming improvements |\n| `speakeasy:generate-terraform-provider` | Generating a Terraform provider from an OpenAPI spec |\n| `speakeasy:extract-openapi-from-code` | Extracting an OpenAPI spec from existing API code (FastAPI, Flask, Django, etc.) |\n| `speakeasy:customize-sdk-hooks` | Adding custom headers, telemetry, security hooks to generated SDKs |\n| `speakeasy:setup-sdk-testing` | Setting up contract tests, Arazzo workflows, or integration tests |\n| `speakeasy:generate-mcp-server` | Generating an MCP server for AI assistant integration |\n| `speakeasy:customize-sdk-runtime` | Configuring retries, timeouts, pagination, server selection, error handling |\n\n## Key Principles\n\n1. **Don't auto-fix everything** - Distinguish between:\n   - Small issues (naming, descriptions) → Fix with overlays\n   - Structural issues (invalid refs) → Ask the user\n   - Design issues (auth, API structure) → Produce strategy document\n\n2. **AI-friendly output** - Use `speakeasy run --output console` for structured output, pipe to `grep`/`tail` to reduce context\n\n3. **Overlay over modify** - Never modify source specs directly. Overlays make patches portable across spec versions.\n\n4. **Grouped SDK methods** - Guide users toward `sdk.users.list()` pattern using `x-speakeasy-group` + `x-speakeasy-name-override`\n\n## Directory Structure\n\n```\nspeakeasy-api/skills/\n├── .claude-plugin/\n│   ├── plugin.json\n│   └── marketplace.json\n├── skills/\n│   ├── start-new-sdk-project/\n│   │   └── SKILL.md\n│   └── ... (13 skills total)\n├── templates/\n│   └── SKILL.template.md\n├── AGENTS.md              # Contributor guidance for AI agents\n├── CLAUDE.md              # Claude-specific contributor guidance\n├── README.md\n└── LICENSE\n```\n\n## Contributing\n\nSee [AGENTS.md](./AGENTS.md) for guidance on creating and maintaining skills.\n\n## Supported Agents\n\nThese skills follow the [Agent Skills specification](https://agentskills.io/specification) and work with:\n\n- [Claude Code](https://claude.ai/code)\n- [Cursor](https://cursor.sh/)\n- [GitHub Copilot](https://github.com/features/copilot)\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- And [15+ other platforms](https://agentskills.io/)\n\n## License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspeakeasy-api%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspeakeasy-api%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspeakeasy-api%2Fskills/lists"}