# Ky

> Provides a concise reference for using the Ky HTTP client, covering core usage, options, retries, hooks, error handling, and best practices.

- Skill: `majiayu000/ky` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/ky`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/ky/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs, REST & GraphQL APIs
- Tags: Bun, Deno, Fetch Api, Http Client, Ky, Nodejs, Typescript
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/majiayu000/ky

---


> 该 skill 基于 Ky v1.14.3，生成于 2026-02-04。

Ky is a tiny and elegant HTTP client based on the Fetch API. It provides a simpler and more powerful API than plain fetch with no dependencies, targeting modern browsers, Node.js 18+, Bun, and Deno.

## Core References

| Topic | Description | Reference |
|-------|-------------|-----------|
| Basic Usage | HTTP method shortcuts, response body methods, TypeScript support | [core-usage](references/core-usage.md) |
| Core Options | json, searchParams, prefixUrl, timeout, method | [core-options](references/core-options.md) |

## Features

### Retry Mechanism

| Topic | Description | Reference |
|-------|-------------|-----------|
| Automatic Retry | Configurable retry strategies, delays, jitter, custom logic | [feature-retry](references/feature-retry.md) |

### Hooks System

| Topic | Description | Reference |
|-------|-------------|-----------|
| Lifecycle Hooks | beforeRequest, beforeRetry, afterResponse, beforeError hooks | [feature-hooks](references/feature-hooks.md) |

### Instance Management

| Topic | Description | Reference |
|-------|-------------|-----------|
| Custom Instances | ky.create(), ky.extend(), context for hooks | [feature-instances](references/feature-instances.md) |

### Error Handling

| Topic | Description | Reference |
|-------|-------------|-----------|
| Error Types | HTTPError, TimeoutError, ForceRetryError, type guards | [feature-errors](references/feature-errors.md) |

## Advanced

| Topic | Description | Reference |
|-------|-------------|-----------|
| Progress Tracking | Upload and download progress callbacks | [advanced-progress](references/advanced-progress.md) |
| Customization | Custom JSON parsing/stringifying, custom fetch | [advanced-customization](references/advanced-customization.md) |

## Best Practices

| Topic | Description | Reference |
|-------|-------------|-----------|
| Form Data | multipart/form-data, URL-encoded forms, file upload | [best-practices-form-data](references/best-practices-form-data.md) |
| Cancellation | AbortController for request cancellation | [best-practices-cancellation](references/best-practices-cancellation.md) |
| Node.js Features | Proxy support, HTTP/2, environment configuration | [best-practices-nodejs](references/best-practices-nodejs.md) |