Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

sdk-development

/sdk-development

Buduje SDK w TypeScript: typowane klienty, obsługę błędów, pakiety ESM, CJS i przeglądarkowe oraz publikację na npm.

Repozytorium
pokayokay ↗
Licencja
MIT
Ostatnia zmiana repozytorium
28.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
13
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Buduje SDK w TypeScript: typowane klienty, obsługę błędów, pakiety ESM, CJS i przeglądarkowe oraz publikację na npm.

Oryginalny opis (EN)

Use when building TypeScript SDKs, extracting shared code into packages, creating developer tooling libraries, designing clean API surfaces, or publishing to npm (public or private). Covers typed clients, error handling, multi-target bundling (ESM/CJS/browser).

Jak działa

  1. Key Principles
  2. Quick Start Checklist
  3. When NOT to Use
  4. References
Sekcje z nagłówków SKILL.md, w oryginale · 44 linii, 298 słów
Podgląd SKILL.md
---
name: sdk-development
description: Use when building TypeScript SDKs, extracting shared code into packages, creating developer tooling libraries, designing clean API surfaces, or publishing to npm (public or private). Covers typed clients, error handling, multi-target bundling (ESM/CJS/browser).
---

# SDK Development

Create professional TypeScript SDKs from scratch or by extraction.

## Key Principles

- **Clean public API** — Export only what consumers need, hide internals
- **Type everything** — Full type coverage for config, methods, responses, and errors
- **Meaningful errors** — Typed error classes with codes and context
- **Sensible defaults** — Works out of the box with minimal config
- **Framework agnostic** — Core SDK has no framework dependencies; add bindings separately

## Quick Start Checklist

1. Analyze scope: new SDK or extraction from existing app
2. Design public API surface (exports, types, config)
3. Implement client with typed methods and error handling
4. Configure build for ESM/CJS/types (tsup recommended)
5. Write tests (unit + integration) and examples
6. Publish to npm with proper package.json exports field

## When NOT to Use

- For consuming external APIs — see api-integration skill
- For publishing to npm only — this skill covers full SDK lifecycle

## References

| Reference | Description |
|-----------|-------------|
| [extraction-scope-and-boundaries.md](references/extraction-scope-and-boundaries.md) | Scope identification, dependency analysis, boundary definition |
| [extraction-usages-and-planning.md](references/extraction-usages-and-planning.md) | Finding usages, test coverage, phased extraction plan |
| [package-structure-and-clients.md](references/package-structure-and-clients.md) | SDK layout, client design patterns (single, modular, factory) |
| [configuration-and-api-design.md](references/configuration-and-api-design.md) | Config interfaces, defaults, barrel exports, method signatures |
| [internal-architecture-and-best-practices.md](references/internal-architecture-and-best-practices.md) | HTTP client, state management, tree-shaking, environment agnostic |
| [type-design.md](references/type-design.md) | Strict types, branded types, generics, discriminated unions |
| [error-handling-and-async.md](references/error-handling-and-async.md) | Error class hierarchy, retry logic, request queues, token management |
| [events-storage-and-logging.md](references/events-storage-and-logging.md) | Event emitter, storage abstraction, logger interface |
| [build-tools-and-output.md](references/build-tools-and-output.md) | tsup config, output formats, package.json exports, TypeScript config |
| [bundle-optimization-and-distribution.md](references/bundle-optimization-and-distribution.md) | Bundle size, multi-platform builds, dual packages, monorepo |
| [publishing-and-registries.md](references/publishing-and-registries.md) | npm publishing, private registries, versioning, changelogs |
| [ci-cd-and-documentation.md](references/ci-cd-and-documentation.md) | GitHub Actions, documentation, pre-publish checklist, deprecation |
Pliki w paczce (13)
  • SKILL.md 3 KB
  • references/build-tools-and-output.md 5 KB
  • references/bundle-optimization-and-distribution.md 5 KB
  • references/ci-cd-and-documentation.md 7 KB
  • references/configuration-and-api-design.md 5 KB
  • references/error-handling-and-async.md 8 KB
  • references/events-storage-and-logging.md 5 KB
  • references/extraction-scope-and-boundaries.md 9 KB
  • references/extraction-usages-and-planning.md 7 KB
  • references/internal-architecture-and-best-practices.md 7 KB
  • references/package-structure-and-clients.md 6 KB
  • references/publishing-and-registries.md 5 KB
  • references/type-design.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie sdk-development.

Migawka bazy z 13.11.2026 · wersja paczki e6b30e2d565d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 1 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100ts-library
    Prowadzi przez tworzenie bibliotek TypeScript: strukturę projektu, eksporty w package.json, wyjście CJS i ESM oraz publikację.
  • 100ts-library
    Prowadzi przez tworzenie bibliotek TypeScript i pakietów npm: konfigurację, exports, budowanie, testy i publikację.
  • 100tsup
    Pakuje biblioteki TypeScript w tsup, opartym na esbuild bez konfiguracji: podwójne wyjście ESM i CJS, pliki deklaracji, tree-shaking i publikacja do npm.
  • 100ts-packaging
    Pomaga publikować bibliotekę TypeScript: mapa exports, JSR czy npm, podwójny ESM i CJS, walidacja typów i provenance.
  • 100rollup
    Pomaga z Rollup przy budowaniu bibliotek JavaScript: formaty wyjściowe ESM i CJS, tree-shaking, wtyczki, kompilacja TypeScript i konfiguracja rollup.config.mjs.
  • 95ts-sdk-author
    Projektuje, buduje, weryfikuje i publikuje SDK w TypeScript jako pakiety npm w monorepo pnpm, z tsdown, exports i changesets.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.