ashish7802/awesome-api-skills

13 stars Quality 71 Trend 40MIT

Production-ready AI coding skills for APIs. Installable skills for Claude Code, Cursor, Codex CLI, Gemini CLI, and modern AI coding agents.

Overview

🔍 Interactive Web Application · 📊 Benchmarks & Diffs · 💻 CLI Reference · 🚀 Quick Start · 🤝 Contributing When AI coding agents (, , , , , or ) generate code for modern APIs, they frequently introduce critical defects caused by stale training data: * ❌ : Parsing raw request bodies with express.json() before verifying cryptographic signatures (e.g. Stripe, Svix, Paddle, Polar), causing SignatureVerificationError. * ❌ : Generating legacy SDK constructors or middleware (e.g. Clerk v4 authMiddleware instead of v5 clerkMiddleware, outdated Vercel AI SDK v2 OpenAIStream instead of v4 streamText). * ❌ : Executing unbatched loops against transactional APIs (Resend, SendGrid, Twilio), resulting in HTTP 429 Too Many Requests. * ❌ : Spawning unpooled database connections inside Serverless functions (Neon, Supabase, PostgreSQL), exhausting connection limits. awesome-api-skills resolves this by providing . Dropping a skill into your workspace (.claude/skills/, .cursor/skills/, .

README

💡 The Problem & The Solution

When AI coding agents (Claude Code, Cursor, Cline, Continue, Windsurf, or OpenAI Codex) generate code for modern APIs, they frequently introduce critical defects caused by stale training data:

❌ Broken Webhook Verification: Parsing raw request bodies with express.json() before verifying cryptographic signatures (e.g. Stripe, Svix, Paddle, Polar), causing SignatureVerificationError.
❌ Deprecated SDK Methods: Generating legacy SDK constructors or middleware (e.g. Clerk v4 authMiddleware instead of v5 clerkMiddleware, outdated Vercel AI SDK v2 OpenAIStream instead of v4 streamText).
❌ Unbatched HTTP Loops: Executing unbatched loops against transactional APIs (Resend, SendGrid, Twilio), resulting in HTTP 429 Too Many Requests.
❌ Missing Connection Pooling: Spawning unpooled database connections inside Serverless functions (Neon, Supabase, PostgreSQL), exhausting connection limits.

awesome-api-skills resolves this by providing 125 curated, schema-validated SKILL.md context files. Dropping a skill into your workspace (.claude/skills/, .cursor/skills/, .agents/skills/) provides deterministic parameters, anti-hallucination checklists, and battle-tested code patterns before a single line of code is generated.

⚡ Real-World Impact: Before vs. After

Integration Domain	❌ Without Skill (LLM Guessing)	✅ With `SKILL.md` (Context Injected)
Stripe Webhooks	Parses JSON with `express.json()`, corrupting raw payload buffer and failing signature verification.	Injects `express.raw({ type: 'application/json' })` so `stripe.webhooks.constructEvent()` verifies authentic HMAC signatures.
DeepSeek R1 / V3	Attempts standard OpenAI chat format without routing reasoning tokens, losing chain-of-thought traces.	Configures `baseURL: "https://api.deepseek.com"` and separates `delta.reasoning_content` from `delta.content`.
Qdrant Vector DB	Upserts embeddings with dimension mismatch against collection configurations.	Enforces exact vector dimension matching and pre-creates payload indexes on filtered fields.
Clerk Next.js Auth	Generates deprecated `authMiddleware({ publicRoutes })` causing App Router runtime crashes.	Uses `clerkMiddleware()` with `createRouteMatcher()` matching Next.js App Router specifications.
Resend Emails	Runs a naive `for...of` loop with individual `send()` calls, taking minutes and hitting rate limits.	Packages payloads into `resend.batch.send([])`, sending up to 500 emails in a single low-latency HTTP roundtrip.
Inngest Workflows	Calls non-deterministic functions (e.g. `Date.now()`, random UUIDs) directly in handler bodies.	Wraps all side-effects and external operations inside `step.run()` for step memoization and durable recovery.

📖 Review complete runnable diffs in docs/BENCHMARKS_AND_EXAMPLES.md.

🚀 Quick Start

1. Direct Copy into Your Project (Zero Dependencies)

Copy the desired skill directory directly into your AI coding agent’s configuration:

# Clone the repository shallowly
git clone --depth 1 https://github.com/Ghost7802/awesome-api-skills.git

# Copy Stripe skill to Claude Code
cp -r awesome-api-skills/skills/stripe .claude/skills/

# Copy DeepSeek skill to Cursor
cp -r awesome-api-skills/skills/deepseek .cursor/skills/

# Copy Qdrant & Inngest skills to generic agent workspace
cp -r awesome-api-skills/skills/qdrant .agents/skills/
cp -r awesome-api-skills/skills/inngest .agents/skills/

Then prompt your assistant:

“Use .claude/skills/stripe/SKILL.md and .claude/skills/inngest/SKILL.md to implement subscription webhooks.”

2. Using the CLI & Workspace Validator

You can search, validate, and inspect skills directly using the repository CLI:

# Search for skills matching keywords
node packages/cli/dist/bin.js search "embeddings vector rag"

# Validate all skills in your workspace
npm run validate:skills

# Diagnose repository & schema integrity
node packages/cli/dist/bin.js doctor

📚 Skill Catalog (125 Verified Skills)

Our catalog covers 125 verified skills across 15 core technical domains:

Category	Skills Included
AI, LLM & Reasoning	`deepseek`, `openai`, `anthropic`, `gemini`, `groq`, `mistral`, `cohere`, `elevenlabs`, `replicate`, `ollama`, `vllm`, `langchain`, `llamaindex`, `vercel-ai-sdk`, `langgraph`, `anthropic-mcp`, `azure-openai`
Vector DB & Search	`qdrant`, `weaviate`, `pinecone`, `meilisearch`, `typesense`, `algolia`, `xquik`
Payments & Billing	`stripe`, `paddle`, `lemon-squeezy`, `braintree`, `revenuecat`, `plaid`, `polar`
Workflows & Background	`inngest`, `trigger-dev`, `bullmq`, `kafka`, `rabbitmq`, `nats`, `redis-streams`
Auth & Security	`svix`, `unkey`, `clerk`, `auth0`, `okta`, `better-auth`, `supabase-ssr`, `jwt`, `oauth2`, `openid-connect`
Databases & ORMs	`postgresql`, `mysql`, `sqlite`, `better-sqlite3`, `cloudflare-d1`, `mongodb-atlas`, `planetscale`, `neon`, `turso`, `supabase`, `firebase`, `drizzle`, `prisma`
Caching & Rate Limiting	`redis`, `upstash`, `upstash-ratelimit`
Cloud & Object Storage	`aws-s3`, `aws-dynamodb`, `azure-blob-storage`, `google-cloud-storage`
Communications & Email	`resend`, `postmark`, `sendgrid`, `twilio`, `novu`, `slack`, `discord`
Backend & Validation	`express`, `fastapi`, `nestjs`, `hono`, `trpc`, `zod`
Frontend Frameworks	`react`, `vue`, `nextjs`, `nuxt`, `sveltekit`
Deployment & Edge	`vercel`, `railway`, `render`, `fly`, `digitalocean`, `cloudflare`, `cloudflare-workers`, `deno-deploy`
Infrastructure & DevOps	`docker`, `kubernetes`, `helm`, `terraform`, `pulumi`, `argo-cd`, `github-actions`, `traefik`, `nginx`, `caddy`, `turborepo`, `linux`
Observability & Analytics	`datadog`, `sentry`, `prometheus`, `grafana`, `loki`, `jaeger`, `opentelemetry`, `mixpanel`, `posthog`
Dev Tools & Platforms	`eslint`, `prettier`, `biome`, `vitest`, `playwright`, `git`, `github`, `shopify`, `mapbox`, `convex`

🌐 Browse the searchable interactive application via npm run dev or the deployed Vercel app.

🏗️ Monorepo Architecture

awesome-api-skills is organized as a high-performance TypeScript workspace:

├── skills/                     # 125 SKILL.md specs, metadata.json contracts & runnable examples
├── src/                        # Interactive React + Vite + Tailwind CSS application
├── api/                        # Vercel Serverless Functions (/api/skills, /api/search, /api/validate)
├── packages/
│   ├── cli/                    # Production CLI binary (search, validate, doctor, benchmark)
│   ├── core/                   # Orchestration runtime and workspace validation
│   ├── validator/              # JSON Schema & Zod structural validation engine
│   ├── registry/               # Knowledge graph index (273 edges) & search resolver
│   ├── generator/              # Template engine & SKILL.md compiler
│   ├── sdk/                    # Programmatic Node.js SDK
│   └── shared-types/           # Shared TypeScript interfaces & types
├── scripts/
│   ├── dev/                    # Dogfooding, benchmark suite & data compiler
│   └── generators/             # Graph and metadata update utilities
└── vercel.json                 # Zero-configuration Vercel fullstack deployment spec

🎯 Verification & Quality Assurance

Every skill in this repository is strictly governed by automated verification pipelines:

Deterministic Schema Enforcement: 100% of skills (125/125) validate against the SKILL.md v1.0 schema specification via packages/validator.
Automated Unit & Catalog Tests: 169 comprehensive tests across 13 test suites run in CI with Vitest.
Verified Knowledge Graph: 273 validated relationship edges map out prerequisites, alternatives, and full-stack integration recipes.
Measured Performance: Live performance.now() telemetry measures workspace parse (~43.6ms) and inverted-index search (<1ms).

🤝 Contributing

We welcome contributions of new API skills and improvements to existing documentation!

Fork and clone the repository:

git clone https://github.com/Ghost7802/awesome-api-skills.git
cd awesome-api-skills
npm install
npm run build:packages

Create your skill under skills// containing SKILL.md and metadata.json.
Run schema validation & test suite:
```
npm run validate:skills
npm test
```
Submit a Pull Request. Our automated GitHub Actions workflow will review and validate the submission.

See CONTRIBUTING.md for full style guidelines and scoring rules.

📄 License

View the full README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add ashish7802/awesome-api-skills

New to MCP? Start with the mcpskill.org guide →