Skip to main content
skill CX Codex

aicore-sdk-js — Claude Code skill: what it does, how to install

aicore-sdk-js is a Claude Code skill that generates runnable TypeScript and JavaScript code for SAP GenAI Hub. It activates on requests to integrate models using @sap-ai-sdk modules.

Apache-2.0 192 installs ★ 153 updated 2026-10-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add SAP/ai-skills-library --skill aicore-sdk-js -a claude-code
Open on GitHub

What aicore-sdk-js does

The skill generates JavaScript and TypeScript boilerplate targeting @sap-ai-sdk v2. It prepares chat and streaming code with @sap-ai-sdk/orchestration, direct OpenAI integrations via @sap-ai-sdk/openai, LangChain pipelines, RAG through @sap-ai-sdk/document-grounding, and batch inference setups.

Execution requires Node.js 22+ with native ESM support and either npm or bun. Lifecycle management for deployments is out of scope: listing, creating, and removing deployments must happen in the SAP AI Core console. A Context7 MCP connection is optional and serves as a dynamic docs lookup when present.

Code generation is restricted to JS and TS runtimes. For Java projects, the skill points to aicore-sdk-java, while Python requests are directed to the official web documentation.

What it helps with

  • generate GenAI Hub completion boilerplate via @sap-ai-sdk/orchestration
  • connect LangChain to SAP AI Core models in TypeScript
  • configure document grounding and RAG with @sap-ai-sdk/document-grounding
  • write batch LLM processing pipelines using @sap-ai-sdk/llm-batch
  • run tabular predictions through @sap-ai-sdk/rpt

Example prompts for the agent

  • Generate a TypeScript streaming script using @sap-ai-sdk/orchestration for SAP GenAI Hub
  • Show how to connect LangChain in Node.js via @sap-ai-sdk/langchain
  • Create a document grounding RAG setup using @sap-ai-sdk/document-grounding

How to install aicore-sdk-js

1Skills CLI (Vercel)

npx skills add SAP/ai-skills-library --skill aicore-sdk-js -a claude-code

2Manually: put the files in place

~/.claude/skills/aicore-sdk-js/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/aicore-sdk-js/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about aicore-sdk-js

How to install aicore-sdk-js in Claude Code?

Run npx skills add SAP/ai-skills-library --skill aicore-sdk-js -a claude-code.

What does aicore-sdk-js do?

It outputs working TypeScript and JavaScript snippets for SAP GenAI Hub across @sap-ai-sdk v2 libraries.

What is required to run aicore-sdk-js?

You need Node.js 22+ with native ESM support, npm or bun, and credentials configured via aicore configure.

Source text

SKILL.md · Apache-2.0
---
name: aicore-sdk-js
metadata:
  version: "2.0"
description: >
  Generate working TypeScript/JavaScript boilerplate for SAP GenAI Hub using @sap-ai-sdk/orchestration,
  @sap-ai-sdk/foundation-models, @sap-ai-sdk/openai (native OpenAI SDK), @sap-ai-sdk/langchain (LangChain),
  @sap-ai-sdk/document-grounding (RAG), @sap-ai-sdk/prompt-registry, @sap-ai-sdk/llm-batch (batch jobs),
  @sap-ai-sdk/rpt (tabular prediction), or @sap-ai-sdk/context-registry (data destinations, tabular artifacts,
  scenario configurations).
  WHEN: user asks for TypeScript, JavaScript, Node.js, or JS/TS code that calls a GenAI Hub
  model, wants a TypeScript starter project, asks how to use @sap-ai-sdk in their app, asks
  how to use LangChain (JS/TS) with SAP AI Core, or wants JS/TS for RAG/document-grounding,
  prompt templates, batch LLM jobs, tabular (RPT) prediction, or managing data destinations /
  tabular artifacts / scenario configurations via the Context Registry.
  DO NOT USE FOR: Java code — use `aicore-sdk-java`. 
compatibility: Requires Node.js 22+ with native ESM support, and npm or bun. Context7 MCP is optional (see Sources & Fallback).
---

## Rules

1. If no deployment URL is known, check the SAP AI Core console or contact your admin to list or create one before generating code.
2. Always include `aicore configure` credential guidance in generated code comments; link to [Connecting to AI Core](https://sap.github.io/ai-sdk/docs/js/connecting-to-ai-core) for setup details.
3. JS/TS lifecycle management (create/list/delete deployments) is not available in this skill — use the SAP AI Core console or contact your admin for deployment management.
4. Target `@sap-ai-sdk` **v2** (orchestration `2.14+`). The preferred invocation pattern is passing `messages` directly to `chatCompletion()` / `stream()`. Only use `promptTemplating.prompt.template` with `{{?placeholder}}` values when the user explicitly wants a server-side reusable template. Never emit the v1 shape `llm: { model_name }` / `templating: { template }` — it does not compile against v2.
5. Never emit Python code snippets — this skill is JS/TS only. If the user asks for Python, inform them that no Python skill is available in this repo and point them to https://sap.github.io/ai-sdk/ for Python SDK guidance.
6. Gather these details before generating code — ask only for what the user hasn't provided:
   - **Framework**: `@sap-ai-sdk/*` (recommended) / `@sap-ai-sdk/langchain` (LangChain) / OpenAI npm package via LiteLLM proxy?
   - **Use case**: chat / streaming / embeddings?
   - **Runtime**: Node.js / Bun / browser?
   - **Model + Deployment ID**: check the SAP AI Core console for existing deployments
   - **Model-switching intent** (ask only when the user specifies an OpenAI model like gpt-4o, gpt-4.1, etc.): do they plan to switch models later (e.g. to Claude or Gemini)? If yes → recommend `@sap-ai-sdk/orchestration` for portability. If they want to stay on OpenAI → use `@sap-ai-sdk/openai` (`SapOpenAi.createClient`) as the simpler native OpenAI SDK alternative; no LiteLLM proxy needed.

---

## Sources & Fallback

Use the best source available, in this order. Never block on a source that isn't present.

1. **Baked-in reference (always available).** `references/SDK_JS.md` and `assets/*.ts` are the
   compile-checked v2 floor. They are correct for the common paths (chat, streaming, LangChain,
   embeddings, proxy) and require no network or MCP. Use them by default.
2. **Context7 MCP (use if available).** _If_ the `context7` `query-docs` tool is registered in
   this session, prefer it for the freshest API, version-specific details, or any feature the
   baked-in reference marks as fast-moving (tool calling, data masking, document grounding,
   prompt registry). Library ID: `/websites/sap_github_io_ai-sdk_js`. If the tool is **not**
   available, silently fall back to the baked-in reference — do not ask the user to install it.
3. **Web docs (last resort).** For anything neither source covers, point to
   [llms.txt](https://sap.github.io/ai-sdk/llms.txt) or fetch the online docs.

Do not fabricate API shapes from memory — this SDK's v1 and v2 APIs differ, and guessing
reproduces stale v1 code. When unsure, use source 2 if present, else source 3.

---

## Asset Map

| Use case                                           | Template                            | Install                                                                              |
| -------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------ |
| Chat via `@sap-ai-sdk/orchestration` (recommended) | `assets/chat_sap_sdk.ts`            | `npm install @sap-ai-sdk/orchestration`                                              |
| Streaming via `@sap-ai-sdk/orchestration`          | `assets/streaming.ts`               | `npm install @sap-ai-sdk/orchestration`                                              |
| Native OpenAI SDK (chat/stream/embeds/Responses)   | `assets/openai_native.ts`           | `npm install @sap-ai-sdk/openai openai zod`                                          |
| LangChain via `AzureOpenAiChatClient`              | `assets/langchain_openai.ts`        | `npm install @sap-ai-sdk/langchain @langchain/core`                                  |
| LangChain via `OrchestrationClient`                | `assets/langchain_orchestration.ts` | `npm install @sap-ai-sdk/langchain @langchain/core`                                  |
| RAG / document grounding                           | `assets/document_grounding.ts`      | `npm install @sap-ai-sdk/document-grounding`                                         |
| Managed prompt templates                           | `assets/prompt_registry.ts`         | `npm install @sap-ai-sdk/prompt-registry`                                            |
| Batch LLM jobs                                     | `assets/llm_batch.ts`               | `npm install @sap-ai-sdk/llm-batch @sap-ai-sdk/ai-api @sap-ai-sdk/foundation-models` |
| Tabular prediction (SAP-RPT-1, not chat)           | `assets/rpt.ts`                     | `npm install @sap-ai-sdk/rpt`                                                        |
| Context Registry (data destinations, tabular artifacts, scenario configs) | `assets/context_registry.ts` | `npm install @sap-ai-sdk/context-registry` |
| Tabular Orchestration (RPT predict via Scenario Config or inline context) | `assets/tabular_orchestration.ts` | `npm install @sap-ai-sdk/tabular-orchestration` |
| Real-time speech/text via WebSocket (`gpt-realtime`)                      | `assets/realtime.ts`              | `npm install @sap-ai-sdk/openai openai ws`      |
| Chat via OpenAI npm package (LiteLLM proxy)        | `assets/chat_openai_proxy.ts`       | `npm install openai`                                                                 |

---

## Install Options

```bash
# @sap-ai-sdk (recommended — native SAP SDK)
npm install @sap-ai-sdk/orchestration @sap-ai-sdk/foundation-models

# Native OpenAI SDK surface on AI Core (no LiteLLM proxy needed)
npm install @sap-ai-sdk/openai openai zod

# LangChain integration (no LiteLLM proxy needed)
npm install @sap-ai-sdk/langchain @langchain/core

# RAG, prompt templates, batch jobs, tabular prediction
npm install @sap-ai-sdk/document-grounding
npm install @sap-ai-sdk/prompt-registry
npm install @sap-ai-sdk/llm-batch @sap-ai-sdk/ai-api @sap-ai-sdk/foundation-models
npm install @sap-ai-sdk/rpt

# With bun
bun add @sap-ai-sdk/orchestration @sap-ai-sdk/foundation-models

# OpenAI npm package via LiteLLM proxy (only if you need a running proxy; prefer @sap-ai-sdk/openai)
npm install openai
```

---

## Quick Start (@sap-ai-sdk/orchestration)

Pass `messages` directly — this is the default pattern. Only use `promptTemplating.prompt.template` with `{{?placeholder}}` values when the user explicitly wants a reusable server-side template.

```typescript
import { OrchestrationClient } from "@sap-ai-sdk/orchestration";

const client = new OrchestrationClient({
  promptTemplating: {
    model: {
      name: "anthropic--claude-4.5-haiku",
      params: { temperature: 0.7 },
    },
  },
});

const response = await client.chatCompletion({
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Hello!" },
  ],
});
console.log(response.getContent());
```

Run with: `npx tsx index.ts` or `bun run index.ts`

---

## Handoffs

- **Want Java code instead?** → invoke `aicore-sdk-java`

---

## When to Load Reference Files

| Trigger                                                     | Load                                                 |
| ----------------------------------------------------------- | ---------------------------------------------------- |
| `@sap-ai-sdk/*` API, OrchestrationClient, streaming         | `references/SDK_JS.md`                               |
| LangChain, `AzureOpenAiChatClient`, `@sap-ai-sdk/langchain` | `references/SDK_JS.md`                               |
| Native OpenAI SDK, `SapOpenAi`, Responses API               | `references/SDK_JS.md`                               |
| RAG, document grounding, prompt registry, batch, RPT        | `references/SDK_JS.md`                               |
| Tool calling, data masking, grounding config internals      | Context7 (if available), else `references/SDK_JS.md` |

© SAP · Apache-2.0 · SAP/ai-skills-library

Similar skills

All skills for AI and ML →

From the same set9

sap-fiori-guidelines sap-fiori-guidelines — a skill that feeds your agent the official SAP Fiori design system rules: buttons, forms, tables, page types, colors, accessibility and Joule patterns. CX Codex +1 1,500installs genai-hub-foundation-models The genai-hub-foundation-models Claude Code skill lists foundation models in SAP AI Core GenAI Hub and shows their details. It runs when a model name or executable ID is needed for a deployment. CX Codex +1 256installs aicore-admin-resources aicore-admin-resources — a skill for Claude Code that verifies SAP AI Core credentials and manages resource groups. Activates during initial environment setup or auth error troubleshooting. CX Codex +1 255installs genai-hub-tabular-orchestration genai-hub-tabular-orchestration — a skill for Claude Code manages the SAP AI Core Context Registry and tabular predictions. It registers HDL connections, exposes CSV or Parquet files as artifacts, and queries sap-rpt models. CX Codex +1 254installs aicore-lifecycle-management aicore-lifecycle-management — a skill for Claude Code that manages lifecycle resources in SAP AI Core. Handles scenarios, executables, configurations, deployments, and inference logs. CX Codex +1 251installs genai-hub-orchestration genai-hub-orchestration — a skill for Claude Code configures SAP AI Core Orchestration pipelines with prompt templates, content filtering, and document grounding. Model requests run through the Harmonized API. CX Codex +1 188installs genai-hub-prompt-evaluation genai-hub-prompt-evaluation — a skill for Claude Code and other platforms that runs GenAI evaluations and benchmarks LLMs on SAP AI Core. Runs when benchmarking prompts or configuring evaluation pipelines. CX Codex +1 185installs aicore-sdk-java aicore-sdk-java — a skill for Claude Code generates Java and Kotlin boilerplate for SAP GenAI Hub using the official SDK. Activated when requesting AI Core integration for Java or Spring Boot applications. CX Codex +1 180installs

Project sponsors

Companies that keep this analytics open