@robosoft/skillhub-cli 0.1.2 → 0.3.3

package/CHANGELOG.md

@@ -1,35 +1,36 @@
 # Changelog
 
-## 0.1.2
+## 0.3.3
 
-- Fixed `skillhub init --target cursor` when `skillhub.json` already exists.
-- Existing projects now update `target`, `skillsDir`, and adapters instead of continuing to create `.ai/skills`.
-- Added clearer init output showing the active target.
+- Changed skill attach output so skill packages do not copy internal `rules/` folders into `.cursor/skills/<name>` or other target skill folders.
+- Kept rules as explicit top-level artifacts installed by `skillhub rule <category/name>`.
+- Updated local skill creation so `skillhub create skill <name>` creates `SKILL.md`, `skill.json`, and `templates/`, but not `rules/`.
 
-## 0.1.1
 
-- Added configurable install targets: `ai`, `cursor`, and `claude`.
-- Added `skillhub target` command.
-- Added `--target` / `--to` support for `init`, `install`, and `sync`.
-- Cursor skills now install under `.cursor/skills` and update `.cursor/rules/skillhub.mdc`.
-- Claude skills now install under `.claude/skills` and update `CLAUDE.md` plus `.claude/skillhub.md`.
-- Added `cloude` alias for `claude`.
+## 0.3.2
 
-# Changelog
+- Changed Cursor rule attachment path from `.cursor/rules/skillhub/<name>.md` to `.cursor/rules/<name>.md`.
+- Added migration for old Cursor config that still points rules to `.cursor/rules/skillhub`.
+- Kept the generated adapter file as `.cursor/rules/skillhub.md` so Cursor has one index file listing attached knowledge.
+
+## 0.3.1
+
+- Treat registry/category prefixes like `frontend/` as lookup-only identifiers.
+- Install local files using the last path segment, for example `frontend/antipattern` -> `antipattern.md`.
+- Store source name, local name, version, and install path in `skillhub.json`.
+- Make `skillhub add` with no arguments restore/reinstall all entries from `skillhub.json`.
+- Allow removal by source path or local name.
 
-## 0.1.0
+## 0.3.0
 
-Initial publishable release of SkillHub CLI.
+- Added short fetch commands: `skillhub skill`, `skillhub rule`, and `skillhub domain`.
+- Added nested path support such as `skillhub rule frontend/antipattern`.
+- Cursor adapter output now uses `.md` files only.
+- Added remote web-app registry contract: `/api/skillhub/:section/:path/:version`.
+- Repositioned CLI as the consumer/fetcher while the SkillHub web app is the authoring system.
+- Added bundled examples for `frontend/app`, `frontend/antipattern`, and `frontend/web-app`.
 
-### Added
+## 0.2.0
 
-- `skillhub init`
-- `skillhub install <skill[@version]>`
-- `skillhub sync`
-- `skillhub list`
-- `skillhub remove <skill>`
-- `skillhub create <skill>`
-- `skillhub validate <skill|path>`
-- `skillhub generate <skill> <template> <name>`
-- Local demo registry with sample skills
-- `AGENTS.md` and Cursor rule adapter generation
+- Added skills, rules, and domain knowledge sections.
+- Added Cursor, Claude, and generic AI targets.

package/README.md

@@ -1,263 +1,243 @@
 # SkillHub CLI
 
-Install reusable AI/project skills into any codebase, similar to installing packages with npm.
+Fetch reusable SkillHub knowledge from a web app or registry and attach it to an IDE project.
 
-A SkillHub skill can include AI instructions, coding rules, templates, checklists, examples, and generator files.
+SkillHub has three knowledge sections:
 
-## Package Name
+- **Skills**: capability/workflow packages, usually folders with `SKILL.md`, `skill.json`, templates, and examples. Rules are attached separately with `skillhub rule ...`.
+- **Rules**: focused `.md` rule files such as `frontend/antipattern.md` or `backend/security.md`.
+- **Domain**: product, business, architecture, or platform knowledge in `.md` files.
 
-```json
-{
-  "name": "@robosoft/skillhub-cli",
-  "bin": {
-    "skillhub": "./bin/skillhub.mjs"
-  }
-}
-```
+The web frontend is the authoring system. Teams create and maintain skills, rules, and domain knowledge there. The CLI is the consumer used inside projects to fetch and attach that knowledge to Cursor, Claude, or a generic `.ai` folder. Yes, finally, the prompts are leaving sticky notes and becoming infrastructure.
 
-The npm package is `@robosoft/skillhub-cli`, but the terminal command is still:
-
-```bash
-skillhub
-```
-
-## Requirements
-
-- Node.js 20+
-
-## Global Install After Publishing
+## Install
 
 ```bash
 npm install -g @robosoft/skillhub-cli
-skillhub --help
 ```
 
-## Publish to npm
-
-This zip is prepared for public npm publishing as `@robosoft/skillhub-cli`.
-
-You must own or have access to the npm scope/organization `@robosoft`.
+If your Mac blocks global install with `EACCES`, set a user-owned npm global directory:
 
 ```bash
-npm login
-npm whoami
-npm org ls robosoft
-npm pack --dry-run
-npm publish --access public
-```
-
-If you do not own the `@robosoft` npm scope, update the `name` field in `package.json` before publishing.
-
-Example fallback:
-
-```json
-{
-  "name": "@vikramrajput1987/skillhub-cli"
-}
-```
-
-## Local Usage
-
-From this folder:
-
-```bash
-npm run skillhub -- --help
-```
-
-Or run directly:
-
-```bash
-node ./bin/skillhub.mjs --help
-```
-
-## Use in Any Project
-
-Create SkillHub config inside your target project. The CLI can now ask where to place skill files:
-
-```bash
-skillhub init
+mkdir -p ~/.npm-global
+npm config set prefix "$HOME/.npm-global"
+echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+npm install -g @robosoft/skillhub-cli
 ```
 
-Or pass the target directly:
+## Quick Start
 
 ```bash
 skillhub init --target cursor
-skillhub init --target claude
-skillhub init --target ai
+skillhub skill frontend/app
+skillhub rule frontend/antipattern
+skillhub domain frontend/web-app
+skillhub list
 ```
 
-Targets:
+Cursor output uses only `.md` files. Registry/category prefixes like `frontend/` are used only for lookup. Locally the CLI installs by the last path segment:
 
 ```txt
-ai      -> .ai/skills + AGENTS.md
-cursor  -> .cursor/skills + .cursor/rules/skillhub.mdc
-claude  -> .claude/skills + CLAUDE.md + .claude/skillhub.md
+.cursor/
+  skills/
+    app/
+      SKILL.md
+      skill.json
+      templates/
+  rules/
+    skillhub.md
+    antipattern.md
+  domain/
+    web-app.md
 ```
 
-Install a skill from a local registry:
+Claude output:
 
-```bash
-skillhub install nextjs-clean-architecture --registry ./skillhub-registry
+```txt
+.claude/
+  skills/
+  rules/
+  domain/
+CLAUDE.md
 ```
 
-Install directly into Cursor skill location:
+Generic AI output:
 
-```bash
-skillhub install nextjs-clean-architecture --target cursor --registry ./skillhub-registry
+```txt
+.ai/
+  skills/
+  rules/
+  domain/
+AGENTS.md
 ```
 
-Install directly into Claude skill location:
+## Commands
 
 ```bash
-skillhub install nextjs-clean-architecture --target claude --registry ./skillhub-registry
-```
+skillhub init --target cursor
+skillhub target claude
 
-Install a specific version:
+# Short commands
+skillhub skill frontend/app
+skillhub rule frontend/antipattern
+skillhub domain frontend/web-app
 
-```bash
-skillhub install shadcn-crud-generator@1.0.0 --registry ./skillhub-registry
-```
+# Equivalent attach syntax
+skillhub attach skill frontend/app
+skillhub attach rule frontend/antipattern
+skillhub attach domain frontend/web-app
 
-List installed skills:
+# Backward compatible install syntax
+skillhub install frontend/app
+skillhub install rule frontend/antipattern
+skillhub install domain frontend/web-app
 
-```bash
+skillhub search frontend
+skillhub sync
+skillhub add          # restore everything listed in skillhub.json
 skillhub list
+skillhub remove rule frontend/antipattern
 ```
 
-Change target later:
+## Web App Registry Usage
 
-```bash
-skillhub target cursor
-skillhub target claude
-skillhub target ai
-```
-
-Sync all skills from `skillhub.json`:
+Point the CLI to your SkillHub web app registry:
 
 ```bash
-skillhub sync
+skillhub init --target cursor --registry https://skillhub.your-company.com
+skillhub rule frontend/antipattern
+skillhub skill frontend/app
+skillhub domain frontend/web-app
 ```
 
-Remove a skill:
+The recommended web API contract is:
 
-```bash
-skillhub remove nextjs-clean-architecture
+```txt
+GET /api/skillhub/:section/:path/:version
 ```
 
-Create a new skill package:
+Examples:
 
-```bash
-skillhub create api-security-rules --category security --version 1.0.0
+```txt
+GET /api/skillhub/rules/frontend/antipattern/latest
+GET /api/skillhub/skills/frontend/app/latest
+GET /api/skillhub/domain/frontend/web-app/latest
 ```
 
-Validate a skill:
+Expected response:
 
-```bash
-skillhub validate api-security-rules --registry ./skillhub-registry
+```json
+{
+  "manifest": {
+    "name": "frontend/antipattern",
+    "version": "1.0.0",
+    "type": "rule",
+    "section": "rules",
+    "entry": "RULE.md"
+  },
+  "files": [
+    {
+      "path": "RULE.md",
+      "content": "# Frontend Anti-Patterns\n..."
+    }
+  ]
+}
 ```
 
-Generate code from an installed template:
+The CLI also supports a registry-only URL style:
 
-```bash
-skillhub install shadcn-crud-generator --registry ./skillhub-registry
-skillhub generate shadcn-crud-generator feature products --out src/features/products
+```txt
+GET /rules/frontend/antipattern/latest
+GET /skills/frontend/app/latest
+GET /domain/frontend/web-app/latest
 ```
 
-## Demo Registry
+## Local Registry Shape
 
-This standalone project includes a demo local registry:
+Useful for local development or bundled examples:
 
 ```txt
 skillhub-registry/
-  nextjs-clean-architecture/
-  shadcn-crud-generator/
-  accessibility-review/
-```
-
-For testing inside this package:
-
-```bash
-npm run demo:init
-npm run demo:install
-npm run demo:list
-npm run demo:validate
+  skills/
+    frontend/
+      app/
+        skill.json
+        SKILL.md
+        templates/
+  rules/
+    frontend/
+      antipattern.md
+      component-standards.md
+  domain/
+    frontend/
+      web-app.md
 ```
 
-## Project Output
+If `./skillhub-registry` does not exist in your project, the CLI falls back to the bundled registry shipped inside the package.
 
-After installing skills, the target project gets files based on the selected target.
+## Project Manifest and Restore
 
-For `--target cursor`:
+Every attached item is stored in `skillhub.json`, using the source path from the web app/registry and the local install name.
 
-```txt
-.cursor/skills/<skill-name>/
-.cursor/rules/skillhub.mdc
-skillhub.json
-skillhub.lock.json
-```
+Example after running:
 
-For `--target claude`:
-
-```txt
-.claude/skills/<skill-name>/
-.claude/skillhub.md
-CLAUDE.md
-skillhub.json
-skillhub.lock.json
+```bash
+skillhub rule frontend/antipattern
+skillhub skill frontend/app
+skillhub domain frontend/web-app
 ```
 
-For `--target ai`:
+`skillhub.json` stores:
 
-```txt
-.ai/skills/<skill-name>/
-AGENTS.md
-skillhub.json
-skillhub.lock.json
+```json
+{
+  "installed": {
+    "skills": {
+      "frontend/app": {
+        "name": "frontend/app",
+        "localName": "app",
+        "version": "1.0.0",
+        "installTo": ".cursor/skills/app"
+      }
+    },
+    "rules": {
+      "frontend/antipattern": {
+        "name": "frontend/antipattern",
+        "localName": "antipattern",
+        "version": "1.0.0",
+        "installTo": ".cursor/rules/antipattern.md"
+      }
+    },
+    "domain": {
+      "frontend/web-app": {
+        "name": "frontend/web-app",
+        "localName": "web-app",
+        "version": "1.0.0",
+        "installTo": ".cursor/domain/web-app.md"
+      }
+    }
+  }
+}
 ```
 
-## Supported Commands
+If someone deletes `.cursor/skills/app` or `.cursor/rules/antipattern.md`, run:
 
-```txt
-skillhub init [--target ai|cursor|claude]
-skillhub target [ai|cursor|claude]
-skillhub install <skill[@version]> [--target ai|cursor|claude]
-skillhub sync
-skillhub list
-skillhub remove <skill>
-skillhub create <skill>
-skillhub validate <skill|path>
-skillhub generate <skill> <template> <name>
+```bash
+skillhub add
 ```
 
-## Remote Registry Contract
+The CLI re-fetches and restores everything listed in `skillhub.json`.
 
-The CLI also supports remote registries:
+Use `--as` only when you want a custom local name:
 
 ```bash
-skillhub install nextjs-clean-architecture --registry https://your-registry.com/api
-```
-
-Expected endpoint format:
-
-```txt
-GET /skills/:name/:version
-GET /skills/:name/latest
+skillhub rule frontend/antipattern --as frontend-antipattern
 ```
 
-Expected response:
+## Publishing
 
-```json
-{
-  "manifest": {
-    "name": "nextjs-clean-architecture",
-    "version": "1.0.0",
-    "entry": "SKILL.md"
-  },
-  "files": [
-    {
-      "path": "SKILL.md",
-      "content": "# Next.js Clean Architecture"
-    }
-  ]
-}
+```bash
+npm login
+npm publish --access public
 ```