AI Skills - Bitrix24 JS SDK

Overview

AI coding agents (Claude Code, Cursor, GitHub Copilot) can load task-focused skill files from the skills/ directory instead of reading the entire repository. Each skill covers one concern — pick only what the current task requires.

Available Skills

Skill	When to use
`b24jssdk-core`	First skill to load — entry point pick (B24Hook / B24Frame / B24OAuth), boot/teardown, error taxonomy, hardErrorCodes / softErrorCodes / retryOnNetworkError tuning
`b24jssdk-rest`	actions.v{2,3}.*.make() — call / batch / callList / fetchList / callTail / fetchTail / batchByChunk; AjaxResult shape; v2/v3 routing (no v3 allowlist)
`b24jssdk-filtering`	v2 prefix-keyed filter vs v3 array-of-triples; operators; dates via Text.toB24Format; order-stripping rule of callList
`b24jssdk-frame-ui`	iframe-only managers: slider / dialog (selectUser/Users/CRM/Access) / parent / placement (with setValue) / options / auth
`b24jssdk-helpers`	useB24Helper, B24HelperManager, Pull client, currency formatting, app/user options
`b24jssdk-recipes`	12 end-to-end TypeScript mini-apps, type-checked in CI via pnpm run skills:typecheck
`b24jssdk-vibecode`	When to combine the SDK with the VibeCode HTTP API

Usage

Each skill is a plain Markdown file at skills/<name>/SKILL.md that follows the Agent Skills open standard, so any agent that reads files can use it. There are two ways to reach the skills: load one inline for a quick session, or install them into your own project so they are always available.

Load inline (this repo)

If your working directory is a checkout of this repository, reference a skill by path:

@skills/b24jssdk-core/SKILL.md

Reference the SKILL.md file itself, not the skills/b24jssdk-core directory — a directory reference only lists the folder's files, it doesn't pull in the skill's content. The path is resolved relative to the current directory, so this only works when b24jssdk itself is the working directory. To use the skills from your own app, install them with one of the methods below.

Claude Code — project install

Copy the skill directories into your project's .claude/skills/. The layout already matches Claude Code's expected .claude/skills/<name>/SKILL.md, so no conversion is needed:

mkdir -p .claude/skills
cp -R path/to/b24jssdk/skills/b24jssdk-* .claude/skills/

Commit .claude/skills/ to version control to share the skills with everyone on the project. Claude loads a skill when it is relevant, or you can invoke one directly with /b24jssdk-core.

Claude Code — personal install

For the same skills across all your projects, copy them into your personal skills folder instead:

mkdir -p ~/.claude/skills
cp -R path/to/b24jssdk/skills/b24jssdk-* ~/.claude/skills/

Personal skills (~/.claude/skills/<name>/SKILL.md) are available in every project without committing anything.

Claude Code — plugin / marketplace

Not yet available. There is currently no .claude-plugin/marketplace.json in this repository, so /plugin marketplace add bitrix24/b24jssdk does not work today. Until a marketplace manifest ships, use the project or personal install above.

Cursor / Windsurf / GitHub Copilot — vendor the files first

These tools have no personal-skills folder, so vendor the skill files into your project first, then point the tool at them:

# clone the whole repo…
git clone https://github.com/bitrix24/b24jssdk

# …or pull only the skills with a sparse checkout
git clone --depth 1 --filter=blob:none --sparse https://github.com/bitrix24/b24jssdk
cd b24jssdk && git sparse-checkout set skills

# …or add it as a submodule inside your project
git submodule add https://github.com/bitrix24/b24jssdk vendor/b24jssdk

Then reference skills/<name>/SKILL.md: in Cursor / Windsurf drag it into chat or use @-file references (or @docs); in GitHub Copilot attach it as a workspace document or paste its path into the chat.

Fetch from the published URL (no clone)

The skills/ directory is also served from the docs site under /.well-known/skills/, so you can pull a skill without cloning the repo:

curl -O https://bitrix24.github.io/b24jssdk/.well-known/skills/b24jssdk-core/SKILL.md

Each skill is at /.well-known/skills/b24jssdk-<name>/SKILL.md. Responses are cached for 24 hours. This is handy for a quick vendor-in step (drop the file into .claude/skills/<name>/ or attach it in another tool) or for tooling that discovers skills over HTTP.

Loading Order

Always start with b24jssdk-core — it covers entry point selection and SDK lifecycle, which every other skill assumes. Then add topic-specific skills based on the task:

b24jssdk-core (always first)
b24jssdk-rest — if making REST calls
b24jssdk-filtering — if building filters or list queries
b24jssdk-frame-ui — if working inside an iframe app
b24jssdk-helpers — if using helper utilities or Pull
b24jssdk-recipes — for complete end-to-end examples

Do not load all skills at once — the descriptions are designed for selective consumption to keep the context focused.