---
docgen:
  source: npm/scripts/skills-cli.mjs
  crc: 85da573a
  score: 100
---

# skills-cli.mjs

## Огляд

Файл надає інструменти для запуску скілів пакета `@nitra/cursor` без синку правил у проєкт. Він зчитує інструкції скілів з файлів `SKILL.md` та збирає контекст з `package.json`, `tsconfig.json` та `.n-cursor.json` для формування промпту. Зібраний промпт делегується в `cursor-agent` або `claude` для виконання необхідних дій.

## Поведінка

normalizeSkillId
Перетворює ім'я скілу на ідентифікатор, видаляючи префікс n-

listSkillIds
Отримує відсортований список ідентифікаторів скілів, що мають файл SKILL.md

buildSkillPrompt
Створює промпт, збираючи інструкцію скілу та контекст поточного проєкту з файлів package.json, tsconfig.json та .n-cursor.json

resolveBundledPackageRoot
Визначає абсолютний шлях до кореня пакета з урахуванням модуля

runSkillsCli
Запускає CLI для виконання скілів, збираючи промпт та контекст проєкту, та делегує виконання в `cursor-agent` або `claude`

## Публічний API

normalizeSkillId — перетворює ідентифікатор навички.
listSkillIds — отримує список ідентифікаторів навичок.
buildSkillPrompt — створює запит для навички.
resolveBundledPackageRoot — визначає основний каталог пакета.
runSkillsCli — запускає клієнт для навичок.

## Гарантії поведінки

- Read-only: файл не виконує операцій запису у файлову систему.
- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
- Не звертається до мережі.
