@nitra/cursor 1.13.69 → 1.13.73

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.13.73] - 2026-05-21
+
+### Fixed
+
+- **Збір workspace-коренів** — `getMonorepoPackageRootDirs` / `getMonorepoProjectRootDirs` більше не трактують `package.json` у `node_modules/`, `.git/`, `.venv/`, `venv/` як воркспейси (glob ignore + `isIgnoredWorkspaceRoot`). Усуває хибні `check changelog` на транзитивних залежностях (наприклад `node-gyp/gyp`).
+
+## [1.13.72] - 2026-05-21
+
+### Changed
+
+- **CLI скілів спрощено** — лише `npx @nitra/cursor skill list`, `skill <id> ["task"]` (промпт на stdout), `skill cursor <id> ["task"]`, `skill claude <id> ["task"]`. Прибрано `skill prompt`, bins `n-skills` / `n-claude`, підкоманду `claude` у `n-cursor`. Зачеплено: [skills-cli.mjs](scripts/skills-cli.mjs).
+
+## [1.13.71] - 2026-05-21
+
+### Added
+
+- **Claude-first UX для скілів** — `npx @nitra/cursor claude taze "task"` і bin **`n-claude`** (замінено спрощеним `skill` у 1.13.72).
+
+## [1.13.70] - 2026-05-21
+
+### Added
+
+- **CLI скілів без синку в проєкт** — `npx @nitra/cursor skill list|prompt|claude|cursor <id> "task"` і bin **`n-skills`** (`npx -p @nitra/cursor n-skills …`). Читає `skills/<id>/SKILL.md` з установленого пакета, збирає промпт із CWD (`package.json`, `tsconfig.json`, `.n-cursor.json`) і виводить на stdout або делегує в `claude -p` / `cursor-agent -p`. Id скілу — каталог у пакеті (`lint`, `fix`, …) або з префіксом `n-` (`n-lint` → `lint`). Зачеплено: [skills-cli.mjs](scripts/skills-cli.mjs), [n-skills.js](bin/n-skills.js), [n-cursor.js](bin/n-cursor.js).
+
 ## [1.13.69] - 2026-05-21
 
 ### Changed

package/bin/n-cursor.js

@@ -19,6 +19,10 @@
  *   `npx \@nitra/cursor lint-docker` — канонічний lint-docker (docker.mdc): `hadolint` по `Dockerfile`/`*.Dockerfile`
  *   `npx \@nitra/cursor lint-text`   — канонічний lint-text (text.mdc): `cspell` → `shellcheck` (з auto-fix) →
  *                                     `markdownlint-cli2 --fix` → `v8r` (json/json5/yaml/yml/toml)
+ *   `npx \@nitra/cursor skill list`     — скіли пакета без синку в проєкт
+ *   `npx \@nitra/cursor skill taze`     — промпт на stdout
+ *   `npx \@nitra/cursor skill cursor taze ["task"]` — Cursor CLI (`cursor-agent -p`)
+ *   `npx \@nitra/cursor skill claude taze ["task"]` — Claude Code CLI (`claude -p`)
  *
  * Agent інтеграція: під час синку, окрім `.cursor/rules` і `.claude/commands` (з skills), CLI ще раз
  * синхронізує `.claude/settings.json` (hooks + permissions; merge — користувацькі поля зберігаються),
@@ -90,6 +94,7 @@ import { runRule } from '../scripts/utils/run-rule.mjs'
 import { syncClaudeConfig } from '../scripts/sync-claude-config.mjs'
 import { upgradeNitraCursorToLatestAndBunInstall } from '../scripts/upgrade-nitra-cursor-and-install.mjs'
 import { runRenameYamlExtensionsCli } from './rename-yaml-extensions.mjs'
+import { runSkillsCli } from '../scripts/skills-cli.mjs'
 import { syncSetupBunDepsAction } from '../scripts/sync-setup-bun-deps-action.mjs'
 
 const PACKAGE_NAME = '@nitra/cursor'
@@ -1304,6 +1309,11 @@ try {
 
       break
     }
+    case 'skill': {
+      process.exitCode = await runSkillsCli(args)
+
+      break
+    }
     case undefined:
     case '': {
       await runSync()
@@ -1313,7 +1323,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, check, rename-yaml-extensions, stop-hook, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text`
+        `   Очікується: (без аргументів) синхронізація правил, check, rename-yaml-extensions, stop-hook, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, skill`
       )
       process.exitCode = 1
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.13.69",
+  "version": "1.13.73",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/scripts/skills-cli.mjs

@@ -0,0 +1,219 @@
+/**
+ * CLI запуску скілів пакета `@nitra/cursor` без синку правил у проєкт.
+ *
+ * Скіли читаються з `npm/skills/<id>/SKILL.md` установленого пакета (або кешу `npx`).
+ * Промпт збирає інструкцію скілу + контекст поточного CWD (`package.json`, `tsconfig.json`,
+ * `.n-cursor.json`) — далі stdout або делегування в `cursor-agent` / `claude`.
+ *
+ * Підтримувані формати:
+ *   `npx @nitra/cursor skill list`
+ *   `npx @nitra/cursor skill taze`
+ *   `npx @nitra/cursor skill cursor taze`
+ *   `npx @nitra/cursor skill cursor taze "онови залежності"`
+ *   `npx @nitra/cursor skill claude taze` — те саме через Claude Code CLI
+ */
+
+import { spawnSync } from 'node:child_process'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { cwd } from 'node:process'
+import { fileURLToPath } from 'node:url'
+
+const RUNNERS = new Set(['cursor', 'claude'])
+
+const USAGE_LINES = [
+  'Usage:',
+  '  npx @nitra/cursor skill list',
+  '  npx @nitra/cursor skill <skill-id> ["task"]',
+  '  npx @nitra/cursor skill cursor <skill-id> ["task"]',
+  '  npx @nitra/cursor skill claude <skill-id> ["task"]',
+  '',
+  'Skill id: каталог у пакеті (lint, taze, …) або з префіксом n- (n-lint → lint).'
+]
+
+/**
+ * @param {string} name
+ * @returns {boolean}
+ */
+function isBinaryInPath(name) {
+  const probe = spawnSync('command', ['-v', name], { shell: true, encoding: 'utf8' })
+  return probe.status === 0
+}
+
+/**
+ * @param {string} name ім'я скілу з CLI або каталогу `.cursor/skills/n-*`
+ * @returns {string} id каталогу в `npm/skills/<id>/`
+ */
+export function normalizeSkillId(name) {
+  if (!name || typeof name !== 'string') {
+    return ''
+  }
+  return name.startsWith('n-') ? name.slice(2) : name
+}
+
+/**
+ * @param {string} skillsRoot абсолютний шлях до `skills/` пакета
+ * @returns {string[]}
+ */
+export function listSkillIds(skillsRoot) {
+  if (!existsSync(skillsRoot)) {
+    return []
+  }
+
+  return readdirSync(skillsRoot, { withFileTypes: true })
+    .filter(entry => entry.isDirectory())
+    .map(entry => entry.name)
+    .filter(name => existsSync(join(skillsRoot, name, 'SKILL.md')))
+    .sort((a, b) => a.localeCompare(b))
+}
+
+/**
+ * @param {string} skillsRoot
+ * @param {string} skillId нормалізований id (без префікса n-)
+ * @returns {string}
+ */
+function getSkillMdPath(skillsRoot, skillId) {
+  return join(skillsRoot, skillId, 'SKILL.md')
+}
+
+/**
+ * @param {string} path
+ * @returns {string | null}
+ */
+function readIfExists(path) {
+  return existsSync(path) ? readFileSync(path, 'utf8') : null
+}
+
+/**
+ * @param {string} skillsRoot
+ * @param {string} rawSkillName
+ * @param {string} task
+ * @param {string} [projectDir]
+ * @returns {string}
+ */
+export function buildSkillPrompt(skillsRoot, rawSkillName, task, projectDir = cwd()) {
+  const skillId = normalizeSkillId(rawSkillName)
+  const skillPath = getSkillMdPath(skillsRoot, skillId)
+
+  if (!skillId || !existsSync(skillPath)) {
+    const available = listSkillIds(skillsRoot).join(', ')
+    throw new Error(`Unknown skill "${rawSkillName}". Available skills: ${available || '(none)'}`)
+  }
+
+  const skill = readFileSync(skillPath, 'utf8')
+  const packageJson = readIfExists(join(projectDir, 'package.json'))
+  const tsconfig = readIfExists(join(projectDir, 'tsconfig.json'))
+  const nCursorJson = readIfExists(join(projectDir, '.n-cursor.json'))
+
+  return [
+    '# Task',
+    task || 'Execute the skill instructions for this project.',
+    '',
+    '# Skill',
+    skill,
+    '',
+    '# Current project',
+    `Directory: ${projectDir}`,
+    '',
+    packageJson ? `## package.json\n\n\`\`\`json\n${packageJson}\n\`\`\`` : '',
+    tsconfig ? `## tsconfig.json\n\n\`\`\`json\n${tsconfig}\n\`\`\`` : '',
+    nCursorJson ? `## .n-cursor.json\n\n\`\`\`json\n${nCursorJson}\n\`\`\`` : ''
+  ]
+    .filter(Boolean)
+    .join('\n\n')
+}
+
+/**
+ * @param {'claude' | 'cursor'} kind
+ * @param {string} prompt
+ * @param {string} projectDir
+ * @returns {number}
+ */
+function runLlmCli(kind, prompt, projectDir) {
+  if (kind === 'claude') {
+    if (!isBinaryInPath('claude')) {
+      throw new Error('`claude` not found in PATH. Install Claude Code CLI or use `skill cursor`.')
+    }
+
+    const result = spawnSync('claude', ['-p'], {
+      input: prompt,
+      cwd: projectDir,
+      stdio: ['pipe', 'inherit', 'inherit'],
+      encoding: 'utf8'
+    })
+    return result.status ?? 1
+  }
+
+  if (!isBinaryInPath('cursor-agent')) {
+    throw new Error('`cursor-agent` not found in PATH. Install Cursor CLI or use `skill claude`.')
+  }
+
+  const result = spawnSync('cursor-agent', ['-p'], {
+    input: prompt,
+    cwd: projectDir,
+    stdio: ['pipe', 'inherit', 'inherit'],
+    encoding: 'utf8'
+  })
+  return result.status ?? 1
+}
+
+/**
+ * Корінь пакета `@nitra/cursor` (каталог з `skills/`, `rules/`, …).
+ * @param {string} [fromModuleUrl] для тестів — `import.meta.url` викликача
+ * @returns {string}
+ */
+export function resolveBundledPackageRoot(fromModuleUrl = import.meta.url) {
+  return join(dirname(fileURLToPath(fromModuleUrl)), '..')
+}
+
+/**
+ * @param {string[]} argv аргументи після `skill` у `n-cursor`
+ * @param {{ packageRoot?: string, projectDir?: string, log?: (line: string) => void, logError?: (line: string) => void }} [options]
+ * @returns {Promise<number>} exit code
+ */
+export async function runSkillsCli(argv, options = {}) {
+  const log = options.log ?? (line => console.log(line))
+  const logError = options.logError ?? (line => console.error(line))
+  const packageRoot = options.packageRoot ?? resolveBundledPackageRoot()
+  const skillsRoot = join(packageRoot, 'skills')
+  const projectDir = options.projectDir ?? cwd()
+
+  const [first, second, ...rest] = argv
+  const skillIds = listSkillIds(skillsRoot)
+
+  try {
+    if (!first) {
+      logError(USAGE_LINES.join('\n'))
+      return 1
+    }
+
+    if (first === 'list') {
+      log('Available skills:')
+      for (const id of skillIds) {
+        log(`- ${id}`)
+      }
+      return 0
+    }
+
+    if (RUNNERS.has(first)) {
+      if (!second) {
+        throw new Error(`Skill name is required after "${first}"`)
+      }
+      const task = rest.join(' ')
+      const prompt = buildSkillPrompt(skillsRoot, second, task, projectDir)
+      return runLlmCli(/** @type {'claude' | 'cursor'} */ (first), prompt, projectDir)
+    }
+
+    if (skillIds.includes(normalizeSkillId(first))) {
+      const task = [second, ...rest].filter(Boolean).join(' ')
+      log(buildSkillPrompt(skillsRoot, first, task, projectDir))
+      return 0
+    }
+
+    logError(USAGE_LINES.join('\n'))
+    return 1
+  } catch (error) {
+    logError(error instanceof Error ? error.message : String(error))
+    return 1
+  }
+}

package/scripts/utils/package-manifest.mjs

@@ -8,7 +8,7 @@ import { dirname, join, relative } from 'node:path'
 
 import { parse as parseToml } from 'smol-toml'
 
-import { getMonorepoPackageRootDirs } from './workspaces.mjs'
+import { getMonorepoPackageRootDirs, isIgnoredWorkspaceRoot } from './workspaces.mjs'
 
 /**
  * @typedef {'npm' | 'python'} PackageKind
@@ -132,12 +132,12 @@ export async function getMonorepoProjectRootDirs(repoRoot = '.') {
     const absDir = dirname(join(repoRoot, relPy))
     const relRoot = relative(repoRoot, absDir)
     const ws = relRoot === '' ? '.' : relRoot
-    if (!existsSync(join(repoRoot, ws, 'package.json'))) {
+    if (!isIgnoredWorkspaceRoot(ws) && !existsSync(join(repoRoot, ws, 'package.json'))) {
       roots.add(ws)
     }
   }
 
-  const list = [...roots]
+  const list = [...roots].filter(ws => !isIgnoredWorkspaceRoot(ws))
   list.sort((a, b) => {
     if (a === '.') return -1
     if (b === '.') return 1

package/scripts/utils/workspaces.mjs

@@ -9,6 +9,32 @@ import { glob, readFile } from 'node:fs/promises'
 import { dirname, join, relative } from 'node:path'
 
 const TRAILING_SLASH_RE = /\/$/
+const LEADING_DOTSLASH_RE = /^\.\//
+
+/** Glob-ігнор для workspace-патернів із `*` (узгоджено з `package-manifest.mjs`). */
+export const WORKSPACE_GLOB_IGNORE = Object.freeze([
+  '**/node_modules/**',
+  '**/.git/**',
+  '**/.venv/**',
+  '**/venv/**'
+])
+
+/**
+ * Чи слід виключити каталог зі списку workspace-коренів (не стосується `.`).
+ * @param {string} ws відносний шлях воркспейсу
+ * @returns {boolean} true — пропустити
+ */
+export function isIgnoredWorkspaceRoot(ws) {
+  if (ws === '.') return false
+  const p = ws.replaceAll('\\', '/').replace(LEADING_DOTSLASH_RE, '')
+  const segments = p.split('/')
+  return (
+    segments.includes('node_modules') ||
+    segments.includes('.git') ||
+    segments.includes('.venv') ||
+    segments.includes('venv')
+  )
+}
 
 /**
  * Нормалізує workspace-патерн до POSIX-формату і прибирає хвостові `/`.
@@ -33,16 +59,22 @@ function normalizeWorkspacePattern(pattern) {
 async function addWorkspaceRootsByPattern(roots, repoRoot, workspacePattern) {
   if (workspacePattern.includes('*')) {
     const globPat = `${workspacePattern}/package.json`
-    for await (const relPkgJsonPath of glob(globPat, { cwd: repoRoot })) {
+    for await (const relPkgJsonPath of glob(globPat, {
+      cwd: repoRoot,
+      ignore: [...WORKSPACE_GLOB_IGNORE]
+    })) {
       const absPkgJsonPath = join(repoRoot, relPkgJsonPath)
       const relRoot = relative(repoRoot, dirname(absPkgJsonPath))
-      roots.add(relRoot === '' ? '.' : relRoot)
+      const ws = relRoot === '' ? '.' : relRoot
+      if (!isIgnoredWorkspaceRoot(ws)) {
+        roots.add(ws)
+      }
     }
     return
   }
 
   const pkgJsonPath = join(repoRoot, workspacePattern, 'package.json')
-  if (existsSync(pkgJsonPath)) {
+  if (existsSync(pkgJsonPath) && !isIgnoredWorkspaceRoot(workspacePattern)) {
     roots.add(workspacePattern)
   }
 }
@@ -77,7 +109,7 @@ export async function getMonorepoPackageRootDirs(repoRoot = '.') {
     const workspacePattern = normalizeWorkspacePattern(raw)
     await addWorkspaceRootsByPattern(roots, repoRoot, workspacePattern)
   }
-  const list = [...roots]
+  const list = [...roots].filter(ws => !isIgnoredWorkspaceRoot(ws))
   list.sort((a, b) => {
     if (a === '.') return -1
     if (b === '.') return 1