@nqlib/nqui 0.5.5 → 0.6.0

package/docs/nqui-skills/shape/SKILL.md

@@ -6,9 +6,12 @@ user-invocable: true
 argument-hint: "[feature to shape]"
 ---
 
-## MANDATORY PREPARATION
+## Context check (lightweight)
 
-Invoke /impeccable, which contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding. If no design context exists yet, you MUST run /impeccable teach first.
+Before proceeding, ensure design context is loaded:
+- If `.impeccable.md` exists in project root, the project context is set — DO NOT re-invoke /impeccable.
+- If `.impeccable.md` is missing, run `/impeccable teach` ONCE to create it.
+- For depth on one topic only, see `impeccable/reference/INDEX.md` and load ONE file.
 
 ---
 

package/docs/nqui-skills/typeset/SKILL.md

@@ -8,9 +8,12 @@ argument-hint: "[target]"
 
 Assess and improve typography that feels generic, inconsistent, or poorly structured — turning default-looking text into intentional, well-crafted type.
 
-## MANDATORY PREPARATION
+## Context check (lightweight)
 
-Invoke /impeccable — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no design context exists yet, you MUST run /impeccable teach first.
+Before proceeding, ensure design context is loaded:
+- If `.impeccable.md` exists in project root, the project context is set — DO NOT re-invoke /impeccable.
+- If `.impeccable.md` is missing, run `/impeccable teach` ONCE to create it.
+- For depth on one topic only, see `impeccable/reference/INDEX.md` and load ONE file.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nqlib/nqui",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "description": "A React component library with enhanced UI components and developer tools",
   "type": "module",
   "main": "./dist/nqui.cjs.js",
@@ -118,6 +118,7 @@
     "nqui-init-css": "scripts/init-css.js",
     "nqui-init-cursor": "scripts/init-cursor.js",
     "nqui-init-skills": "scripts/download-skills.js",
+    "nqui-init-claude-skills": "scripts/install-claude-skills.js",
     "nqui-install-peers": "scripts/install-peers.js",
     "nqui-init-debug": "scripts/init-debug-css.js",
     "nqui-setup": "scripts/post-install.js"

package/scripts/cli.js

@@ -6,6 +6,7 @@
  * Usage:
  *   npx @nqlib/nqui init-css [output.css]
  *   npx @nqlib/nqui init-cursor
+ *   npx @nqlib/nqui init-claude-skills
  *   npx @nqlib/nqui install-peers
  *   npx @nqlib/nqui init-debug
  *   npx @nqlib/nqui setup
@@ -21,6 +22,7 @@ const subcommand = process.argv[2];
 const routes = {
   'init-cursor': './init-cursor.js',
   'init-skills': './download-skills.js',
+  'init-claude-skills': './install-claude-skills.js',
   'install-peers': './install-peers.js',
   'init-debug': './init-debug-css.js',
   'init-debug-css': './init-debug-css.js',

package/scripts/install-claude-skills.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * Install nqui skills for Claude Code / Claude Desktop.
+ *
+ * Usage: npx @nqlib/nqui init-claude-skills [--force]
+ *
+ * Copies packages/nqui/docs/nqui-skills/* → ~/.claude/skills/<skill-name>/
+ * Hub markdown → ~/.claude/skills/nqui/
+ * Component docs → ~/.claude/skills/nqui-components/components/
+ */
+
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { getPackageRoot } from './getPackageRoot.js';
+
+const root = getPackageRoot();
+const SKILLS_SOURCE = join(root, 'docs', 'nqui-skills');
+const COMPONENTS_SOURCE = join(root, 'docs', 'components');
+const CLAUDE_SKILLS = join(homedir(), '.claude', 'skills');
+
+const HUB_FILES = [
+  'SKILL.md',
+  'README.md',
+  'HUMAN_GUIDE.md',
+  'COMPOSITION.md',
+  'COMPONENTS_INDEX.md',
+  'READ_BUDGET.md',
+];
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+}
+
+function isSkillDir(name) {
+  const path = join(SKILLS_SOURCE, name);
+  return statSync(path).isDirectory() && existsSync(join(path, 'SKILL.md'));
+}
+
+function patchHubSkill(destSkillPath) {
+  let content = readFileSync(destSkillPath, 'utf8');
+  content = content.replace(
+    /Installed into `\.cursor\/nqui-skills\/` via `npx @nqlib\/nqui init-skills`\./,
+    'Installed into `~/.claude/skills/` via `npx @nqlib/nqui init-claude-skills`.',
+  );
+  content = content.replace(
+    /- `\.cursor\/nqui-skills\/components\/nqui-<name>\.md` \(after init-skills\)/,
+    '- `~/.claude/skills/nqui-components/components/nqui-<name>.md`',
+  );
+  content = content.replace(
+    /SSOT: `packages\/nqui\/docs\/nqui-skills\/`/,
+    'SSOT: `packages/nqui/docs/nqui-skills/` (repo) · installed: `~/.claude/skills/`',
+  );
+  writeFileSync(destSkillPath, content);
+}
+
+export async function installClaudeSkills({ force = true } = {}) {
+  if (!existsSync(SKILLS_SOURCE)) {
+    console.error('Source skills not found:', SKILLS_SOURCE);
+    process.exit(1);
+  }
+
+  ensureDir(CLAUDE_SKILLS);
+
+  const hubDest = join(CLAUDE_SKILLS, 'nqui');
+  if (existsSync(hubDest) && !force) {
+    console.log('⏭️  ~/.claude/skills/nqui exists. Use --force to overwrite.');
+  } else {
+    ensureDir(hubDest);
+    for (const file of HUB_FILES) {
+      const src = join(SKILLS_SOURCE, file);
+      if (existsSync(src)) cpSync(src, join(hubDest, file), { force: true });
+    }
+    patchHubSkill(join(hubDest, 'SKILL.md'));
+    console.log('✅ Hub →', hubDest);
+  }
+
+  for (const name of readdirSync(SKILLS_SOURCE)) {
+    if (!isSkillDir(name)) continue;
+    const dest = join(CLAUDE_SKILLS, name);
+    if (existsSync(dest) && !force) {
+      console.log(`⏭️  ${name} — use --force to overwrite`);
+      continue;
+    }
+    cpSync(join(SKILLS_SOURCE, name), dest, { recursive: true, force: true });
+    console.log('✅', name, '→', dest);
+  }
+
+  const componentsDest = join(CLAUDE_SKILLS, 'nqui-components', 'components');
+  if (existsSync(COMPONENTS_SOURCE)) {
+    if (existsSync(componentsDest) && !force) {
+      console.log('⏭️  nqui-components/components — use --force to overwrite');
+    } else {
+      ensureDir(join(CLAUDE_SKILLS, 'nqui-components'));
+      cpSync(COMPONENTS_SOURCE, componentsDest, { recursive: true, force: true });
+      console.log('✅ Component docs →', componentsDest);
+    }
+  }
+
+  console.log('\n📚 Claude skills installed under ~/.claude/skills/');
+  console.log('   Restart Claude Code or Claude Desktop to pick them up.');
+  console.log('   Hub: /nqui · Components: /nqui-components · Design: /nqui-design-system');
+}
+
+const force = process.argv.includes('--force') || !process.argv.includes('--no-force');
+installClaudeSkills({ force }).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});