v1.2.0

AI Skills

Task-focused skill files for AI coding agents working with @bitrix24/b24jssdk.

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

SkillWhen to use
b24jssdk-coreFirst skill to load — entry point pick (B24Hook / B24Frame / B24OAuth), boot/teardown, error taxonomy, hardErrorCodes / softErrorCodes / retryOnNetworkError tuning
b24jssdk-restactions.v{2,3}.*.make() — call / batch / callList / fetchList / batchByChunk; AjaxResult shape; v3 method whitelist
b24jssdk-filteringv2 prefix-keyed filter vs v3 array-of-triples; operators; dates via Text.toB24Format; order-stripping rule of callList
b24jssdk-frame-uiiframe-only managers: slider / dialog (selectUser/Users/CRM/Access) / parent / placement (with setValue) / options / auth
b24jssdk-helpersuseB24Helper, B24HelperManager, Pull client, currency formatting, app/user options
b24jssdk-recipes12 end-to-end TypeScript mini-apps, type-checked in CI via pnpm run skills:typecheck
b24jssdk-vibecodeWhen to combine the SDK with the VibeCode HTTP API

Usage

Load a skill by referencing it in the agent's context. Examples:

Claude Code — add to the system prompt or reference inline:

@skills/b24jssdk-core

Cursor / Windsurf — use @docs or drag the skill file into the chat context.

GitHub Copilot — attach the skill file as a workspace document or paste its path into the chat.

Skills are plain Markdown files and can be read directly from skills/<name>/SKILL.md in the repository root.

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:

  1. b24jssdk-core (always first)
  2. b24jssdk-rest — if making REST calls
  3. b24jssdk-filtering — if building filters or list queries
  4. b24jssdk-frame-ui — if working inside an iframe app
  5. b24jssdk-helpers — if using helper utilities or Pull
  6. 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.

Further Reading

See AGENTS.md for full contributor and agent documentation, including commands, testing, and key conventions.