@robosoft/skillhub-cli 0.1.0

package/docs/skillhub-cli-logic.md

@@ -0,0 +1,145 @@
+# SkillHub CLI Logic
+
+## Goal
+
+The CLI installs reusable project skills into any repository, similar to how package managers install dependencies.
+
+A SkillHub skill is a folder that contains:
+
+```txt
+skill.json
+SKILL.md
+rules/
+templates/
+checklist/
+examples/
+```
+
+## Commands
+
+### `skillhub init`
+
+Creates project-level SkillHub files:
+
+```txt
+skillhub.json
+skillhub.lock.json
+.ai/skills/
+```
+
+### `skillhub install <skill[@version]>`
+
+Flow:
+
+1. Read `skillhub.json`.
+2. Resolve the registry from `--registry`, `SKILLHUB_REGISTRY`, or `skillhub.json`.
+3. Load the skill package from local registry or remote API.
+4. Validate `skill.json` and `SKILL.md`.
+5. Copy files into `.ai/skills/<skill-name>`.
+6. Update `skillhub.json`.
+7. Update `skillhub.lock.json` with version, source, checksum, and install path.
+8. Update adapters such as `AGENTS.md` and `.cursor/rules/skillhub.mdc`.
+
+### `skillhub sync`
+
+Reinstalls all skills listed in `skillhub.json`.
+
+### `skillhub list`
+
+Reads `skillhub.lock.json` and prints installed skills.
+
+### `skillhub remove <skill>`
+
+Deletes the installed skill folder, removes it from config and lock, then refreshes adapters.
+
+### `skillhub create <skill>`
+
+Scaffolds a new local skill package into the registry.
+
+### `skillhub validate <skill|path>`
+
+Checks whether a skill has valid metadata and required files.
+
+### `skillhub generate <skill> <template> <name>`
+
+Generates project files from an installed skill template.
+
+Example:
+
+```bash
+skillhub install shadcn-crud-generator
+skillhub generate shadcn-crud-generator feature products --out src/features/products
+```
+
+Template files can use variables like:
+
+```txt
+{{name}}
+{{kebabName}}
+{{camelName}}
+{{pascalName}}
+{{title}}
+```
+
+## Local Registry Format
+
+```txt
+skillhub-registry/
+  nextjs-clean-architecture/
+    1.0.0/
+      skill.json
+      SKILL.md
+      rules/
+      checklist/
+```
+
+## Remote Registry Contract
+
+The CLI supports remote registries with this endpoint pattern:
+
+```txt
+GET /skills/:name/:version
+GET /skills/:name/latest
+```
+
+Expected response:
+
+```json
+{
+  "manifest": {
+    "name": "nextjs-clean-architecture",
+    "version": "1.0.0",
+    "entry": "SKILL.md"
+  },
+  "files": [
+    {
+      "path": "SKILL.md",
+      "content": "# Next.js Clean Architecture"
+    }
+  ]
+}
+```
+
+## Adapter Output
+
+The CLI can update these files:
+
+```txt
+AGENTS.md
+.cursor/rules/skillhub.mdc
+CLAUDE.md
+.github/copilot-instructions.md
+```
+
+The enabled adapters are controlled in `skillhub.json`:
+
+```json
+{
+  "adapters": {
+    "agentsMd": true,
+    "cursorRules": true,
+    "claude": false,
+    "githubCopilot": false
+  }
+}
+```

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@robosoft/skillhub-cli",
+  "version": "0.1.0",
+  "description": "Standalone SkillHub CLI for installing reusable AI/project skills into any codebase.",
+  "type": "module",
+  "bin": {
+    "skillhub": "./bin/skillhub.mjs"
+  },
+  "scripts": {
+    "skillhub": "node ./bin/skillhub.mjs",
+    "start": "node ./bin/skillhub.mjs",
+    "test:help": "node ./bin/skillhub.mjs --help",
+    "demo:init": "node ./bin/skillhub.mjs init",
+    "demo:install": "node ./bin/skillhub.mjs install nextjs-clean-architecture --registry ./skillhub-registry",
+    "demo:list": "node ./bin/skillhub.mjs list",
+    "demo:validate": "node ./bin/skillhub.mjs validate nextjs-clean-architecture --registry ./skillhub-registry",
+    "prepublishOnly": "node ./bin/skillhub.mjs --help",
+    "pack:dry-run": "npm pack --dry-run",
+    "publish:public": "npm publish --access public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "bin",
+    "docs",
+    "skillhub-registry",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "ai",
+    "skills",
+    "cli",
+    "agents",
+    "cursor",
+    "claude",
+    "developer-tools",
+    "templates"
+  ],
+  "author": "Vikram Rajput",
+  "license": "MIT",
+  "homepage": "https://github.com/robosoft/skillhub-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robosoft/skillhub-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/robosoft/skillhub-cli/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skillhub-registry/README.md

@@ -0,0 +1,23 @@
+# SkillHub Local Registry
+
+This folder acts as a local skill registry for the demo CLI.
+
+Each skill package follows this structure:
+
+```txt
+skillhub-registry/
+  skill-name/
+    1.0.0/
+      skill.json
+      SKILL.md
+      rules/
+      templates/
+      checklist/
+```
+
+Install a skill into any project from the repository root:
+
+```bash
+node packages/@robosoft/skillhub-cli/bin/skillhub.mjs init
+node packages/@robosoft/skillhub-cli/bin/skillhub.mjs install nextjs-clean-architecture
+```

package/skillhub-registry/accessibility-review/1.0.0/SKILL.md

@@ -0,0 +1,22 @@
+# Accessibility Review
+
+## Purpose
+
+Use this skill when reviewing UI components, navigation flows, forms, dialogs, carousels, and data-heavy screens.
+
+## Review Rules
+
+1. Every interactive element must be reachable by keyboard.
+2. Focus order must match visual order.
+3. Dialogs must trap focus and restore it on close.
+4. Buttons need meaningful accessible names.
+5. Form inputs need labels, validation messaging, and error association.
+6. Dynamic updates should announce meaningful changes when needed.
+7. Color contrast should pass WCAG AA for normal text.
+
+## Common Failure Points
+
+- Icon-only buttons without labels.
+- Divs pretending to be buttons, the classic costume party of broken UX.
+- Modals that lose focus.
+- Carousels that auto-rotate without pause controls.

package/skillhub-registry/accessibility-review/1.0.0/checklist/ui-review.md

@@ -0,0 +1,8 @@
+# UI Accessibility Checklist
+
+- [ ] Keyboard-only navigation works.
+- [ ] Visible focus indicator is present.
+- [ ] Screen reader labels are meaningful.
+- [ ] Form errors are announced or associated.
+- [ ] Dialog focus is trapped and restored.
+- [ ] Color contrast is acceptable.

package/skillhub-registry/accessibility-review/1.0.0/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "accessibility-review",
+  "version": "1.0.0",
+  "description": "Accessibility checklist for reviewing UI, keyboard behavior, focus states, and screen-reader output.",
+  "category": "quality",
+  "tags": ["a11y", "accessibility", "ui", "review"],
+  "entry": "SKILL.md",
+  "compatibleWith": ["cursor", "claude", "chatgpt", "github-copilot"]
+}

package/skillhub-registry/nextjs-clean-architecture/1.0.0/SKILL.md

@@ -0,0 +1,37 @@
+# Next.js Clean Architecture
+
+## Purpose
+
+Use this skill when building or reviewing a scalable Next.js App Router project with TypeScript, server components, server actions, and reusable UI components.
+
+## Core Rules
+
+1. Keep business logic out of React components.
+2. Prefer feature-based folders for domain code.
+3. Use server components by default and client components only where browser APIs, state, or events are required.
+4. Keep data access inside services, repositories, or server actions.
+5. Model request and response types clearly.
+6. Every user-facing view needs loading, empty, error, and success states.
+7. Accessibility cannot be treated like decoration added after the building collapses.
+
+## Recommended Folder Pattern
+
+```txt
+src/
+  app/
+  features/
+    users/
+      components/
+      actions/
+      services/
+      schema/
+      types/
+  components/
+    ui/
+  lib/
+  db/
+```
+
+## Output Expectations
+
+When generating code, include the relevant file paths, TypeScript types, validation rules, and integration steps.

package/skillhub-registry/nextjs-clean-architecture/1.0.0/checklist/definition-of-done.md

@@ -0,0 +1,9 @@
+# Definition of Done
+
+- [ ] TypeScript types are explicit where needed.
+- [ ] Loading state is handled.
+- [ ] Empty state is handled.
+- [ ] Error state is handled.
+- [ ] Server/client boundary is intentional.
+- [ ] Accessibility labels and keyboard paths are checked.
+- [ ] Code is easy to delete or refactor later.

package/skillhub-registry/nextjs-clean-architecture/1.0.0/rules/folder-structure.md

@@ -0,0 +1,7 @@
+# Folder Structure Rules
+
+- Use `features/<feature-name>` for domain-specific code.
+- Use `components/ui` only for generic reusable UI primitives.
+- Use `lib` for shared helpers and platform clients.
+- Use `db` for database configuration and schema exports.
+- Avoid dumping everything into `utils`, the drawer of forgotten sins.

package/skillhub-registry/nextjs-clean-architecture/1.0.0/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "nextjs-clean-architecture",
+  "version": "1.0.0",
+  "description": "Next.js App Router architecture rules, folder patterns, and delivery checklist.",
+  "category": "frontend",
+  "tags": ["nextjs", "react", "typescript", "architecture"],
+  "entry": "SKILL.md",
+  "compatibleWith": ["cursor", "claude", "chatgpt", "github-copilot"]
+}

package/skillhub-registry/shadcn-crud-generator/1.0.0/SKILL.md

@@ -0,0 +1,25 @@
+# Shadcn CRUD Generator
+
+## Purpose
+
+Use this skill when creating admin CRUD modules with Next.js, TypeScript, server actions, Shadcn UI, and a predictable folder structure.
+
+## CRUD Rules
+
+1. Each module must include list, create, edit, delete, and view patterns where applicable.
+2. Use schema validation before mutation.
+3. Keep table column definitions separate from page composition when the table grows.
+4. Add confirmation before destructive actions.
+5. Show toast or visible feedback after mutation.
+6. Never hide errors in `console.log`, because that is not observability, that is denial.
+
+## Generated Files
+
+```txt
+features/<module>/
+  components/
+  actions/
+  schema/
+  types/
+  data/
+```

package/skillhub-registry/shadcn-crud-generator/1.0.0/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "shadcn-crud-generator",
+  "version": "1.0.0",
+  "description": "CRUD scaffolding guidance and templates for Next.js + Shadcn admin panels.",
+  "category": "generator",
+  "tags": ["shadcn", "crud", "nextjs", "admin"],
+  "entry": "SKILL.md",
+  "compatibleWith": ["cursor", "claude", "chatgpt", "github-copilot"]
+}

package/skillhub-registry/shadcn-crud-generator/1.0.0/templates/feature/actions.ts.hbs

@@ -0,0 +1,16 @@
+"use server";
+
+export async function create{{pascalName}}Action(input: unknown) {
+  // Validate input, persist data, then revalidate affected paths.
+  return { success: true };
+}
+
+export async function update{{pascalName}}Action(id: string, input: unknown) {
+  // Validate id + input, update data, then revalidate affected paths.
+  return { success: true };
+}
+
+export async function delete{{pascalName}}Action(id: string) {
+  // Validate id, delete safely, then revalidate affected paths.
+  return { success: true };
+}

package/skillhub-registry/shadcn-crud-generator/1.0.0/templates/feature/page.tsx.hbs

@@ -0,0 +1,13 @@
+import { {{pascalName}}Table } from "@/features/{{kebabName}}/components/{{kebabName}}-table";
+
+export default async function {{pascalName}}Page() {
+  return (
+    <main className="space-y-6">
+      <div>
+        <h1 className="text-2xl font-semibold">{{title}}</h1>
+        <p className="text-muted-foreground">Manage {{title}} records.</p>
+      </div>
+      <{{pascalName}}Table />
+    </main>
+  );
+}