@robosoft/skillhub-cli 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 0.1.0
+
+Initial publishable release of SkillHub CLI.
+
+### Added
+
+- `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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SkillHub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,206 @@
+# SkillHub CLI
+
+Install reusable AI/project skills into any codebase, similar to installing packages with npm.
+
+A SkillHub skill can include AI instructions, coding rules, templates, checklists, examples, and generator files.
+
+## Package Name
+
+```json
+{
+  "name": "@robosoft/skillhub-cli",
+  "bin": {
+    "skillhub": "./bin/skillhub.mjs"
+  }
+}
+```
+
+The npm package is `@robosoft/skillhub-cli`, but the terminal command is still:
+
+```bash
+skillhub
+```
+
+## Requirements
+
+- Node.js 20+
+
+## Global Install After Publishing
+
+```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`.
+
+```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:
+
+```bash
+skillhub init
+```
+
+Install a skill from a local registry:
+
+```bash
+skillhub install nextjs-clean-architecture --registry ./skillhub-registry
+```
+
+Install a specific version:
+
+```bash
+skillhub install shadcn-crud-generator@1.0.0 --registry ./skillhub-registry
+```
+
+List installed skills:
+
+```bash
+skillhub list
+```
+
+Sync all skills from `skillhub.json`:
+
+```bash
+skillhub sync
+```
+
+Remove a skill:
+
+```bash
+skillhub remove nextjs-clean-architecture
+```
+
+Create a new skill package:
+
+```bash
+skillhub create api-security-rules --category security --version 1.0.0
+```
+
+Validate a skill:
+
+```bash
+skillhub validate api-security-rules --registry ./skillhub-registry
+```
+
+Generate code from an installed template:
+
+```bash
+skillhub install shadcn-crud-generator --registry ./skillhub-registry
+skillhub generate shadcn-crud-generator feature products --out src/features/products
+```
+
+## Demo Registry
+
+This standalone project includes a demo local registry:
+
+```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
+```
+
+## Project Output
+
+After installing skills, the target project gets files like:
+
+```txt
+.ai/skills/<skill-name>/
+AGENTS.md
+.cursor/rules/skillhub.mdc
+skillhub.json
+skillhub.lock.json
+```
+
+## Supported Commands
+
+```txt
+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>
+```
+
+## Remote Registry Contract
+
+The CLI also supports remote registries:
+
+```bash
+skillhub install nextjs-clean-architecture --registry https://your-registry.com/api
+```
+
+Expected endpoint format:
+
+```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"
+    }
+  ]
+}
+```