llm-api-builder
/llm-api-builder
Build apps with the Claude API or Anthropic SDK. TRIGGER when code imports anthropic, @anthropic-ai/sdk, or claude_agent_sdk, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. Також використовуй, коли користувач хоче: збудувати застосунок на Claude API, інтегрувати Anthropic SDK, налаштувати tool use / function calling, streaming, Batch API, structured outputs чи prompt caching. DO NOT TRIGGER when code imports openai or other AI SDK, general programming, or ML/data-science tasks. НЕ використовувати для openai чи інших не-Anthropic SDK.
- Author
- patriotai ↗
- Repository
- ai-lab ↗
- Licence
- MIT
- Last repository change
- 26.10.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/skill_guard.py
What it does and when to use it
Build apps with the Claude API or Anthropic SDK. TRIGGER when code imports anthropic, @anthropic-ai/sdk, or claude_agent_sdk, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. Також використовуй, коли користувач хоче: збудувати застосунок на Claude API, інтегрувати Anthropic SDK, налаштувати tool use / function calling, streaming, Batch API, structured outputs чи prompt caching. DO NOT TRIGGER when code imports openai or other AI SDK, general programming, or ML/data-science tasks. НЕ використовувати для openai чи інших не-Anthropic SDK.
Original author description
Build apps with the Claude API or Anthropic SDK. TRIGGER when code imports anthropic, @anthropic-ai/sdk, or claude_agent_sdk, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. Також використовуй, коли користувач хоче: збудувати застосунок на Claude API, інтегрувати Anthropic SDK, налаштувати tool use / function calling, streaming, Batch API, structured outputs чи prompt caching. DO NOT TRIGGER when code imports openai or other AI SDK, general programming, or ML/data-science tasks. НЕ використовувати для openai чи інших не-Anthropic SDK.
How it works
- 🛡️ Протокол Збереження Перед Оновленням (ОБОВ'ЯЗКОВО)
- Critical Facts
- Вибір поверхні (Surface Decision)
- Замовчування (Defaults)
- Визначення мови (Language Detection)
- Яку поверхню обрати?
- Архітектура
- Поточні моделі (агностично)
- Thinking & Effort (швидка довідка)
- Compaction (швидка довідка)
SKILL.md preview
---
name: llm-api-builder
description: "Build apps with the Claude API or Anthropic SDK. TRIGGER when code imports anthropic, @anthropic-ai/sdk, or claude_agent_sdk, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. Також використовуй, коли користувач хоче: збудувати застосунок на Claude API, інтегрувати Anthropic SDK, налаштувати tool use / function calling, streaming, Batch API, structured outputs чи prompt caching. DO NOT TRIGGER when code imports openai or other AI SDK, general programming, or ML/data-science tasks. НЕ використовувати для openai чи інших не-Anthropic SDK."
license: MIT
metadata:
version: 1.5.2
author: Melania (Master Administrator)
category: api-building
created: 2026-06-02
last_updated: 2026-10-16
---
# Building LLM-Powered Applications with Claude — v1.5.2
> Пояснення — українською за замовчуванням (українською-перша); код, ідентифікатори та поля API лишаються англійською. Перемикання мови лише слідом за користувачем.
## 🛡️ Протокол Збереження Перед Оновленням (ОБОВ'ЯЗКОВО)
Обов'язковий перед БУДЬ-ЯКОЮ зміною цього скіла. **Канонічне джерело (не дублювати тут):** `melania` — секції «🛡️ Протокол Збереження Перед Оновленням» + «Update Workflow» + «Core Rule 10 — Re-Read Before Update».
Стисло: re-read диску → порівняти версії (диск новіший → диск база) → integrity-diff → validation-mesh → safety-compliance-gate (перед пакуванням/публікацією) → backup/snapshot → merge-not-replace → bump+CHANGELOG → показати diff і чекати явного схвалення MA (Закон II).
---
## Critical Facts
- **[C] Streaming потрібен для довгих входів/виходів — рятує від request timeouts.** За замовчуванням для запитів з потенційно довгим входом, виходом чи високим `max_tokens` вживай streaming; SDK-хелпер `.get_final_message()` / `.finalMessage()` збирає повну відповідь.
- **[C] `budget_tokens` на поточних флагманських моделях deprecated** — там діє `thinking: {type: "adaptive"}` без бюджету. Параметр лишається валідним для старіших поколінь; актуальну поведінку звіряй у docs.
- **[C] Tool Search Tool дає −85% контексту для великих tool-бібліотек.** Замість вантажування всіх визначень інструментів у контекст (77K) підвантажуй їх пошуком (8.7K); механіка — у Advanced Tool Use.
- **[C] Programmatic Tool Calling дає −37% токенів на складних research-задачах.** Модель викликає інструменти з code-execution середовища, фільтруючи проміжні дані (43.6K→27.3K); beta-можливість для агентів з великими наборами інструментів.
- **[C] Стиснення/edits щотурну вбивають prompt-cache.** Тримай system+інструменти незмінними й стискай лише хвіст конверсації; інакше cache-підтримка втрачається.
---
## Вибір поверхні (Surface Decision)
| Завдання | Поверхня |
|---|---|
| Швидкий прототип, артефакт | API в артефакті (fetch до api.anthropic.com) |
| Production бекенд | Python SDK `anthropic` |
| Node.js/TypeScript | `@anthropic-ai/sdk` |
| Агентні workflow | Claude Agent SDK (`claude_agent_sdk`) |
| Batch 10k+ запитів | Batch API (async, знижка 50%) |
## Замовчування (Defaults)
Якщо користувач не просить інакше:
Для моделі Claude — за замовчуванням бери **найновішу доступну модель**, а не «запінений» ID: рядки моделей і ціни часто змінюються. Звіряй поточну модель через скіл `product-self-knowledge` або https://docs.claude.com; таблиця нижче — **кешований знімок**, а не джерело істини. Для будь-чого хоч трохи складного — за замовчуванням adaptive thinking (`thinking: {type: "adaptive"}`). І нарешті — за замовчуванням streaming для будь-якого запиту з потенційно довгим входом, довгим виходом чи високим `max_tokens`: це рятує від request timeouts. Щоб отримати повну відповідь, не обробляючи окремі stream-події, використовуй хелпер SDK `.get_final_message()` / `.finalMessage()`.
---
## Визначення мови (Language Detection)
Перш ніж читати приклади коду, визнач, якою мовою працює користувач:
1. **Подивись на файли проекту**, щоб вивести мову:
* `*.py`, `requirements.txt`, `pyproject.toml`, `setup.py`, `Pipfile` → **Python** — читай з `python/`
* `*.ts`, `*.tsx`, `package.json`, `tsconfig.json` → **TypeScript** — читай з `typescript/`
* `*.js`, `*.jsx` (без `.ts`) → **TypeScript** — JS використовує той самий SDK, читай з `typescript/`
* `*.java`, `pom.xml`, `build.gradle` → **Java** — читай з `java/`
* `*.kt`, `*.kts`, `build.gradle.kts` → **Java** — Kotlin використовує Java SDK, читай з `java/`
* `*.scala`, `build.sbt` → **Java** — Scala використовує Java SDK, читай з `java/`
* `*.go`, `go.mod` → **Go** — читай з `go/`
* `*.rb`, `Gemfile` → **Ruby** — читай з `ruby/`
* `*.cs`, `*.csproj` → **C#** — читай з `csharp/`
* `*.php`, `composer.json` → **PHP** — читай з `php/`
2. **Якщо виявлено кілька мов**: перевір, до якої мови стосується поточний файл чи питання користувача. Якщо досі неоднозначно — спитай, яка мова.
3. **Якщо мову не вивести**: за замовчуванням приклади Python (зазнач це).
4. **Якщо мова не підтримується** (Rust, Swift, C++ тощо): запропонуй cURL / raw HTTP приклади.
5. **Якщо потрібні cURL / raw HTTP приклади**, читай з `curl/`.
### Підтримка можливостей за мовами
| Мова | Tool Runner | Agent SDK | Нотатки |
|------|-------------|-----------|---------|
| Python | Так (beta) | Так | Повна підтримка — декоратор `@beta_tool` |
| TypeScript | Так (beta) | Так | Повна підтримка — `betaZodTool` + Zod |
| Java | Так (beta) | Ні | Beta tool use з анотованими класами |
| Go | Так (beta) | Ні | `BetaToolRunner` у пакеті `toolrunner` |
| Ruby | Так (beta) | Ні | `BaseTool` + `tool_runner` у beta |
| cURL | N/A | N/A | Raw HTTP, без можливостей SDK |
| C# | Ні | Ні | Офіційний SDK |
| PHP | Ні | Ні | Офіційний SDK |
---
## Яку поверхню обрати?
> **Починай з простого.** За замовчуванням — найпростіший рівень, що покриває потребу.
| Сценарій | Рівень | Рекомендована поверхня | Чому |
|----------|--------|------------------------|------|
| Класифікація, summarization, extraction, Q&A | Single LLM call | **Claude API** | Один запит, одна відповідь |
| Batch-обробка чи embeddings | Single LLM call | **Claude API** | Спеціалізовані endpoint'и |
| Багатокрокові пайплайни з логікою в коді | Workflow | **Claude API + tool use** | Ти оркеструєш цикл |
| Кастомний агент з власними інструментами | Agent | **Claude API + tool use** | Максимум гнучкості |
| AI-агент з доступом до файлів/веб/терміналу | Agent | **Agent SDK** | Вбудовані інструменти, safety, MCP |
| Агентний кодувальний асистент | Agent | **Agent SDK** | Створено саме для цього |
| Потрібні вбудовані дозволи й guardrails | Agent | **Agent SDK** | Safety-можливості включено |
### Дерево рішень
```text
Що потрібно твоєму застосунку?
1. Один LLM-виклик (класифікація, summarization, extraction, Q&A)
└── Claude API — один запит, одна відповідь
2. Чи потрібно Claude читати/писати файли, ходити в веб або виконувати shell-команди?
└── Так → Agent SDK — вбудовані інструменти
3. Workflow (багатокроковий, оркестрований кодом, з власними інструментами)
└── Claude API з tool use — ти контролюєш цикл
4. Відкритий агент (модель сама обирає траєкторію, твої інструменти)
└── Claude API agentic loop (максимум гнучкості)
```
---
## Архітектура
Усе йде через `POST /v1/messages`. Інструменти й обмеження виводу — це можливості цього єдиного endpoint'а.
**User-defined tools** — ти визначаєш інструменти (через декоратори, Zod-схеми чи raw JSON), а tool runner SDK сам викликає API, виконує твої функції й крутить цикл, доки Claude не завершить.
**Server-side tools** — інструменти, що хостяться Anthropic і виконуються на її інфраструктурі.
**Structured outputs** — `output_config: {format: {...}}` на `messages.create()`. Рекомендований підхід — `client.messages.parse()`.
**Допоміжні endpoint'и** — Batches (`POST /v1/messages/batches`), Files (`POST /v1/files`), Token Counting.
---
## Поточні моделі (агностично)
> **Конкретні model ID/ціни/ctx НЕ живуть тут.** Датований знімок — у спільному замінному файлі
> `multi-provider-ai-orchestration/references/model-snapshot-YYYY-MM.md` (DRY, поточний — найновіший файл у тій теці).
> Авторитет — `product-self-knowledge` / https://docs.claude.com. **За замовчуванням — найновіша
> доступна модель**; пінь конкретну старішу лише коли користувач явно її називає.
## Thinking & Effort (швидка довідка)
**Поточні флагмани — adaptive thinking (рекомендовано):** `thinking: {type: "adaptive"}`. На поточних флагманах `budget_tokens` deprecated.
**Effort-параметр (GA):** `output_config: {effort: "low"|"medium"|"high"|"max"}`. Замовчування — `high`. `max` — лише для топ-Opus.
**Adaptive thinking** підтримується поточними Sonnet/Opus; `budget_tokens` на них deprecated.
**Старіші моделі (лише за явним запитом):** `thinking: {type: "enabled", budget_tokens: N}`. `budget_tokens` має бути менший за `max_tokens` (мінімум 1024).
> ⚠️ `budget_tokens` валідний **лише для старіших поколінь** (межу звір у docs). Не використовуй із поточними флагманами — звір актуальну поведінку в docs.
---
## Compaction (швидка довідка)
**Beta, поточні топ-моделі (звір docs, які саме).** Потребує beta-хедер `compact-2026-01-12`. API автоматично підсумовує ранній контекст при наближенні до порога. Ключі: `context_management.edits` (конфігурація), trigger threshold конфігурується (від ~50K), `pause_after_compaction` — зупинка після компакції для інспекції. Додавай `response.content` (не лише текст) назад у messages щоходу. Компакція, що переписує префікс щотурну, ВБИВАЄ prompt-cache — тримай стабільний кеш-префікс. (Звір поточну доступність/умови в docs.)
## Memory Tool (швидка довідка)
**GA на поточних поколіннях (звір docs).** Client-side tool `memory_20250818`: модель читає/пише файли в sandbox-директорії `/memories` через твій handler. ОБОВ'ЯЗКОВО: path-traversal захист у handler (валідація що шлях лишається в `/memories`). Емпірика Anthropic: context editing + memory tool = **+39% якості проти baseline, −84% токенів** на 100-turn агентних задачах; context editing сам = +29%. Патерн: pre-compaction memory flush (важливе → у memory ПЕРЕД компакцією). Деталі — docs memory-tool.
## Advanced Tool Use (швидка довідка)
Три beta-можливості для агентів з великими наборами інструментів (звір хедери в docs):
- **Programmatic Tool Calling** — модель викликає інструменти з code-execution середовища, фільтруючи проміжні дані: **−37% токенів** на складних research-задачах (43.6K→27.3K).
- **Tool Search Tool** — інструменти підвантажуються пошуком замість усіх визначень у контексті: **−85% контексту** (77K→8.7K) для великих tool-бібліотек.
- **Tool Use Examples** — приклади викликів у визначенні інструмента: parameter accuracy **72%→90%**.
---
## Гайд читання (Reading Guide)
> ℹ️ **Нотатка:** Цей SKILL.md — точка входу. Мовно-специфічні reference-файли (`{lang}/claude-api/README.md`, `shared/tool-use-concepts.md` тощо) живуть у повному GitHub-репо [`anthropics/skills/skills/claude-api/`](https://github.com/anthropics/skills/tree/main/skills/claude-api). Тягни їх через `web_fetch` за потреби.
Після визначення мови читай релевантні файли:
- **Один text classification/summarization/extraction/Q&A:** `{lang}/claude-api/README.md`
- **Chat UI чи real-time показ відповіді:** `README.md` + `streaming.md`
- **Function calling / tool use / агенти:** `README.md` + `shared/tool-use-concepts.md` + `tool-use.md`
- **Batch-обробка:** `README.md` + `batches.md`
- **File uploads через кілька запитів:** `README.md` + `files-api.md`
- **Агент із вбудованими інструментами:** `{lang}/agent-sdk/README.md` + `patterns.md`
---
## Часті пастки (Common Pitfalls)
* Не обрізай вхід, передаючи файли чи контент в API.
* **Thinking на поточних флагманах:** `thinking: {type: "adaptive"}` — НЕ використовуй `budget_tokens`.
* **Prefill:** на найновіших Opus assistant-prefill може повертати 400 — звір у docs перед використанням prefill.
* **128K output tokens:** `.stream()` з `.get_final_message()` / `.finalMessage()`.
* **Batch API до 300K output:** beta-хедер `output-300k-2026-03-24` (звір docs) — для довгих batch-генерацій.
* **Structured outputs:** `output_config: {format: {...}}` замість deprecated `output_format`.
* **Не визначай власні типи для структур даних SDK:** використовуй `Anthropic.MessageParam`, `Anthropic.Tool` тощо.
* **Звіти й документи на виході:** code-execution sandbox має передвстановлені `python-docx`, `python-pptx`, `matplotlib`, `pillow`, `pypdf`.
---
## 📎 Advanced Patterns (v4)
Читай `references/advanced-api.md`, КОЛИ потрібні: prompt caching (до 90% економії), citations, vision, PDF, Files API, structured output, batch+tools.
Вантаж лише на вимогу — не проактивно.
---
## Зміни
- **v1.5.2** (2026-10-16) — Вказівник на знімок моделей став не-старіючим (без зашитого «2026-07»): знімок оновлено до 2026-10 у `multi-provider-ai-orchestration`. Логіка скіла не змінена.
- **v1.5.1** (2026-09-28) — Ліцензія скіла уніфікована до **MIT** разом з усією екосистемою (директива власника). Зміна лише метаданих; поведінка й артефакт незмінні.
- **v1.5.0** (2026-07-26) — Секція **Critical Facts**: фактичні твердження скіла винесено окремо й протеговано [C] за Core Rule 14 (claim-evidence). Лише додавання.
- **v1.4.1** (2026-07-19) — Self-Dev Wave 2 (аудит 2026-07-18): ліцензійний покажчик виправлено на корінь екосистеми (локального LICENSE.txt не існувало) [#25/#44]; H1-банер з версією [#21/#45-клас]. Лише метадані.
- **v1.4.0** (2026-07-11) — Frontier-research harvest + принцип модельної агностичності: **(A)** Секцію «Поточні моделі» де-піновано: таблиця конкретних ID/цін → покажчик на спільний датований снапшот у `multi-provider` (DRY) + правило «найновіша доступна». **(B)** Compaction розширено (агностично): `context_management.edits`, конфігурований поріг, `pause_after_compaction`, попередження про кеш-префікс. **(C)** НОВА секція Memory Tool: sandbox-патерн, path-traversal захист, емпірика +39%/−84%, pre-compaction flush — без прив'язки до поколінь. **(D)** НОВА секція Advanced Tool Use: Programmatic Tool Calling (−37% токенів), Tool Search Tool (−85% контексту), Tool Use Examples (72→90%). **(E)** Pitfalls: +Batch довгий output (beta, звір хедер у docs). Лише додавання/де-пін; API-ідентифікатори (tool-типи, beta-хедери) збережені — це документація API, не пін моделей. _(Джерело: дослідницький звіт 2026-07-11 + правило агностичності MA.)_
- **v1.3.0** (2026-06-26) — Повна UA-локалізація (Task 1): технічну прозу (Defaults, Language Detection, Architecture, Reading Guide, Pitfalls, таблиці) перекладено українською; код / API / ідентифікатори лишаються англійською. +власні `evals/` (5, канон-схема). **S-1:** знімок моделей оновлено (Opus 4.6→4.8, `claude-opus-4-8`); version-tied claims генералізовано на «поточні флагмани» + verify-нота (без вигадування цін 4.8). **S-2:** дубльовану секцію «Зміни» + дубль v1.2.0 консолідовано (вміст збережено). Переклад + додавання; функціонал не змінено.
- **v1.2.1** (2026-06-15) — DRY: «Протокол Збереження» → тонкий міст на канон у `melania` (де-дублювання + усунення 8-варіантного дрейфу). Поведінка незмінна.
- **v1.2.0** (2026-06-02) — `metadata`-блок, директива «українською-перша», власні `evals/` (5); де-хардкод моделей (найновіша + звірка з product-self-knowledge/docs); Pre-Update Preservation Protocol; `advanced-api` reference (prompt caching, citations, vision, PDF, Files API). _(аудит Кластер 3: P5 + P9 + Core Rule 4)_
- **v1.1.0** (2026-06-02) — extended thinking API, streaming+tools, Batch API, token counting, surface decision table.
Files in this package (5)
- SKILL.md 21 KB
- evals/evals.json 2 KB
- references/advanced-api.md 6 KB
- scripts/skill_guard.py 3 KB
- scripts/.snapshots/latest.json 2 KB
Versions
The database has no other skills named llm-api-builder.
Database snapshot: 13.11.2026 · package version efba33352a29 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95claude-api
Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`/`claude_agent_sdk`, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports `openai`/other AI SDK, general programming, or ML/data-science tasks. - 100claude-api
Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`/`claude_agent_sdk`, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports `openai`/other AI SDK, general programming, or ML/data-science tasks. - 100claude-api
Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`/`claude_agent_sdk`, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports `openai`/other AI SDK, general programming, or ML/data-science tasks. - 100claude-api
Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`/`claude_agent_sdk`, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports `openai`/other AI SDK, general programming, or ML/data-science tasks. - 100claude-api
Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`/`claude_agent_sdk`, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports `openai`/other AI SDK, general programming, or ML/data-science tasks. - 100claude-api
Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`/`claude_agent_sdk`, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports `openai`/other AI SDK, general programming, or ML/data-science tasks.