feat(cli): rename npm package to skillx-sh and add README

Author: mrgoonie

.github/workflows/release-cli.yml

@@ -14,6 +14,7 @@ jobs:
     outputs:
       release_created: ${{ steps.release.outputs['packages/cli--release_created'] }}
       tag_name: ${{ steps.release.outputs['packages/cli--tag_name'] }}
+      version: ${{ steps.release.outputs['packages/cli--version'] }}
     steps:
       - uses: googleapis/release-please-action@v4
         id: release
@@ -38,9 +39,9 @@ jobs:
         run: pnpm install --frozen-lockfile
 
       - name: Build CLI
-        run: pnpm --filter skillx build
+        run: pnpm --filter skillx-sh build
 
       - name: Publish to NPM
-        run: pnpm --filter skillx publish --no-git-checks --access public
+        run: pnpm --filter skillx-sh publish --no-git-checks --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

packages/cli/README.md

@@ -0,0 +1,88 @@
+# skillx-sh
+
+The Only Skill That Your AI Agent Needs.
+
+CLI for the [SkillX.sh](https://skillx.sh) marketplace — search, discover, and use AI agent skills from your terminal.
+
+## Install
+
+```bash
+npm install -g skillx-sh
+```
+
+Or run directly with npx:
+
+```bash
+npx skillx-sh search "code review"
+```
+
+## Commands
+
+### `skillx search <query>`
+
+Search the SkillX marketplace for skills.
+
+```bash
+skillx search "code review"
+skillx search "database migration"
+```
+
+### `skillx find <query>`
+
+Interactive search — browse results and select a skill to view details.
+
+```bash
+skillx find "testing"
+```
+
+### `skillx use <slug>`
+
+View a skill's details and content. Supports GitHub `org/repo` format — if the skill isn't registered yet, it auto-registers from the repo.
+
+```bash
+skillx use my-skill
+skillx use owner/repo          # auto-registers from GitHub
+skillx use my-skill --raw      # output raw content (for piping)
+```
+
+### `skillx report <slug> <outcome>`
+
+Report skill usage outcome (requires API key).
+
+```bash
+skillx report my-skill success
+skillx report my-skill failure --model claude-sonnet-4 --duration 5000
+```
+
+### `skillx config`
+
+Manage CLI configuration.
+
+```bash
+skillx config set-key          # set your API key
+skillx config set-url <url>    # set custom API URL
+skillx config show             # show current config
+```
+
+## Configuration
+
+**API Key** — get yours at [skillx.sh/settings](https://skillx.sh/settings), then:
+
+```bash
+skillx config set-key
+```
+
+Or set via environment variable:
+
+```bash
+export SKILLX_API_KEY=your-key-here
+```
+
+## Links
+
+- Website: [skillx.sh](https://skillx.sh)
+- GitHub: [github.com/nextlevelbuilder/skillx](https://github.com/nextlevelbuilder/skillx)
+
+## License
+
+MIT

packages/cli/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "skillx",
+  "name": "skillx-sh",
   "version": "0.1.1",
   "description": "The Only Skill That Your AI Agent Needs.",
   "type": "module",
@@ -27,7 +27,8 @@
   },
   "files": [
     "bin",
-    "dist"
+    "dist",
+    "README.md"
   ],
   "keywords": [
     "ai",

release-please-config.json

@@ -2,7 +2,7 @@
   "packages": {
     "packages/cli": {
       "release-type": "node",
-      "package-name": "skillx",
+      "package-name": "skillx-sh",
       "changelog-path": "CHANGELOG.md",
       "bump-minor-pre-major": true,
       "bump-patch-for-minor-pre-major": true