docs(skills): review the skill installation methods and fill any gaps

[IgorShevchik]

Context

The AI Skills page
(source: docs/content/docs/1.getting-started/7.ai/1.skills.md)
does a nice job listing the seven skills and the recommended loading order. The skills themselves are already in
good shape — each skills/b24jssdk-*/SKILL.md has valid name + description frontmatter, i.e. they follow the
Claude Code "Agent Skills" layout. The page was just audited (audited: 2026-05-29), so this is more of a light
follow-up than a complaint. 🙂

While re-reading it, it felt like the page leans toward loading a skill (referencing it inline) more than
installing it into a project that isn't a clone of this repo — which is probably the most common case for
someone building a Bitrix24 app. It might be worth walking through each installation path end-to-end and topping
up whatever's thin.

A few things that might be worth checking

No urgency on any of these — grouping them so they're easy to pick off:

• Verify the per-tool instructions still work as written. The Claude Code example uses
  @skills/b24jssdk-core, which assumes this repo is the working directory. Worth confirming that's the intended
  story, or whether it should point at a copied-in skill instead.
• Claude Code — project install. Consider documenting copying skills/b24jssdk-* into a consumer
  project's .claude/skills/<name>/SKILL.md (the format already matches, so this should "just work").
• Claude Code — personal install. Same idea for ~/.claude/skills/ when someone wants the skills
  available across all their projects.
• Claude Code — plugin/marketplace. There's currently no .claude-plugin/marketplace.json (or plugin
  manifest) in the repo, so /plugin marketplace add bitrix24/b24jssdk isn't an option today. Since the skills
  are already well-formed, packaging them as an installable plugin could be a nice low-effort add — worth a look
  if it fits the roadmap.
• Cursor / Windsurf / GitHub Copilot. The page mentions @docs / drag-and-drop / attach-as-document.
  Could be worth a short "vendor the files first" note (clone, sparse-checkout, or submodule) so non-Claude users
  have a concrete starting point.
• Cross-check with the official Claude Code Skills docs so terminology (project vs personal vs plugin)
  matches what those tools actually expect.
• If any of the above turns out to be missing, just add a short subsection per method — no need for anything
  heavy.

Notes / out of scope

• Skill content is already covered by chore(skills): verify skill files against current SDK surface and real portal behaviour #113 (verifying skills against the live SDK surface) — this issue is
  only about the installation/distribution instructions, not the skill bodies.
• Keeping skills/README.md and the docs page in sync would be a bonus if they drift while editing.

Related

• Docs source: docs/content/docs/1.getting-started/7.ai/1.skills.md
• Skills + their format: skills/, skills/README.md
• Agent skills section in AGENTS.md
• chore(skills): verify skill files against current SDK surface and real portal behaviour #113 — skill content verification (sibling effort)