askill-cli 0.1.0 → 0.1.2

package/README.md

@@ -2,19 +2,62 @@
 
 > The package manager for AI agent skills.
 
-[![npm version](https://img.shields.io/npm/v/@askill/cli.svg)](https://www.npmjs.com/package/@askill/cli)
+[![npm version](https://img.shields.io/npm/v/askill-cli.svg)](https://www.npmjs.com/package/askill-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
+<details>
+<summary><strong>🤖 For AI Agents (click to expand)</strong></summary>
+
+You are an AI agent helping a user with askill - a package manager for AI agent skills.
+
+**Quick Commands:**
+```bash
+# Install a skill
+askill add owner/repo@skill-name -y
+
+# Install all skills from a repo
+askill add owner/repo --all -y
+
+# List installed skills
+askill list
+
+# Search for skills
+askill find <query>
+
+# Run a skill command
+askill run skill-name:command
+```
+
+**Key Behaviors:**
+- Use `-y` flag to skip confirmation prompts
+- Use `-a <agent>` to specify target agent (claude-code, cursor, opencode, etc.)
+- Skills are installed to `.agents/skills/` and symlinked to agent directories
+- Check `~/.agents/.skill-lock.json` for installed skill metadata
+
+**For Skill Development:**
+- Read [`docs/skill-spec.md`](./docs/skill-spec.md) for SKILL.md format
+- Use `askill init` to create a new skill template
+- Use `askill validate` to check SKILL.md syntax
+
+**Installed Skills:**
+After installation, read the skill's `SKILL.md` file for usage instructions. Skills are located at:
+- Project: `.agents/skills/<skill-name>/SKILL.md`
+- Global: `~/.agents/skills/<skill-name>/SKILL.md`
+
+</details>
+
+---
+
 askill is a universal package manager for AI agent skills. It enables agents to discover, install, and use skills across Claude Code, Cursor, Windsurf, and 40+ other AI coding assistants.
 
 ## Quick Start
 
 ```bash
 # Install
-npm install -g @askill/cli
+curl -fsSL https://askill.sh | sh
 
-# Install a skill from GitHub
-askill add gh:owner/repo@skill-name
+# Install a skill
+askill add owner/repo@skill-name
 
 # Search for skills
 askill find code review
@@ -23,29 +66,24 @@ askill find code review
 askill list
 ```
 
-## Table of Contents
+## Installation
 
-- [Installation](#installation)
-- [Usage](#usage)
-- [Documentation](#documentation)
-- [Skills](#skills)
-- [For Developers](#for-developers)
-- [Project Structure](#project-structure)
-- [Contributing](#contributing)
-- [License](#license)
+### One-line install (recommended)
 
-## Installation
+```bash
+curl -fsSL https://askill.sh | sh
+```
 
-### npm (recommended)
+### npm
 
 ```bash
-npm install -g @askill/cli
+npm install -g askill-cli
 ```
 
 ### npx (no install)
 
 ```bash
-npx @askill/cli add @anthropic/memory
+npx askill-cli add owner/repo@skill-name
 ```
 
 ### Verify
@@ -59,105 +97,75 @@ askill --version
 ### Install a Skill
 
 ```bash
-# From GitHub (short format)
-askill add gh:facebook/react@extract-errors
+# From GitHub
+askill add facebook/react@extract-errors
 
-# From GitHub (path format)
-askill add gh:facebook/react/scripts/error-codes
+# Browse and select from a repo
+askill add anthropics/courses
+
+# Install all skills from a repo
+askill add owner/repo --all
 
 # Non-interactive (for CI/agents)
-askill add gh:owner/repo@skill -y
+askill add owner/repo@skill -y
 ```
 
-### Search Skills
+### Search & Discover
 
 ```bash
 askill find memory
-askill find --tag git
+askill find code review
 ```
 
-### List Installed Skills
+### Manage Skills
 
 ```bash
+# List installed
 askill list
 askill list -g  # global only
-```
 
-### Run Skill Commands (Planned)
+# Check for updates
+askill check
 
-Skills can define commands. When implemented, run them with:
+# Update skills
+askill update
 
-```bash
-askill run <skill>:<command> [args]
+# Remove
+askill remove skill-name
 
-# Example
-askill run @anthropic/memory:save --key preferences --value "dark mode"
-askill run @anthropic/memory:recall --key preferences
+# Update CLI itself
+askill upgrade
 ```
 
-### Remove a Skill
+### Run Skill Commands
+
+Skills can define executable commands:
 
 ```bash
-askill remove @anthropic/memory
+askill run skill-name:command [args]
+
+# Example
+askill run memory:save --key name --value "John"
 ```
 
 ## Documentation
 
-Complete documentation is available in the [`docs/`](./docs/) directory:
-
 | Document | Description |
 |----------|-------------|
-| [Introduction](./docs/introduction.md) | What is askill and why it exists |
-| [Getting Started](./docs/getting-started.md) | Quick start guide with examples |
-| [SKILL.md Specification](./docs/skill-spec.md) | Complete protocol for writing skills |
-| [Slug System](./docs/slug-system.md) | How skill identification works (`@scope/name` vs `gh:`) |
-| [Publishing Guide](./docs/publishing.md) | How to publish your own skills |
+| [Getting Started](./docs/getting-started.md) | Quick start guide |
 | [CLI Reference](./docs/cli-reference.md) | Complete command documentation |
-| [API Specification](./docs/api-spec.md) | REST API for askill.sh |
-
-### For AI Agents
+| [SKILL.md Specification](./docs/skill-spec.md) | How to write skills |
+| [Publishing Guide](./docs/publishing.md) | Publish your own skills |
 
-If you're an AI agent trying to understand askill:
+## Creating Skills
 
-1. **To use installed skills**: Read [`skills/@askill/agent/SKILL.md`](./skills/@askill/agent/SKILL.md)
-2. **To develop skills**: Read [`skills/@askill/developer/SKILL.md`](./skills/@askill/developer/SKILL.md)
-3. **To understand the protocol**: Read [`docs/skill-spec.md`](./docs/skill-spec.md)
-
-## Skills
-
-### Slug System
-
-Skills are identified by slugs:
-
-| Type | Format | Example |
-|------|--------|---------|
-| Published | `@scope/name` | `@anthropic/memory` |
-| Indexed | `gh:owner/repo/path` | `gh:facebook/react/scripts/errors` |
-
-Published skills are hosted on [askill.sh](https://askill.sh). Indexed skills are automatically discovered from GitHub.
-
-### Official Skills
-
-| Skill | Description | Path |
-|-------|-------------|------|
-| `@askill/agent` | Teaches agents how to use installed skills | [`skills/@askill/agent/`](./skills/@askill/agent/SKILL.md) |
-| `@askill/developer` | Teaches agents how to develop skills | [`skills/@askill/developer/`](./skills/@askill/developer/SKILL.md) |
-
-### SKILL.md Format
-
-Skills are defined by a `SKILL.md` file:
+1. Create a `SKILL.md` file:
 
 ```markdown
 ---
 name: my-skill
 description: What this skill does
 version: 1.0.0
-dependencies:
-  - @dependency/one@^1.0.0
-commands:
-  build:
-    run: npm run build
-    description: Build the project
 ---
 
 # My Skill
@@ -165,85 +173,15 @@ commands:
 Instructions for the agent...
 ```
 
-See [SKILL.md Specification](./docs/skill-spec.md) for complete details.
-
-## For Developers
-
-### Creating a Skill
-
-1. Create a `SKILL.md` file with frontmatter and instructions
 2. Test locally: `askill add ./my-skill`
-3. Validate: `askill validate SKILL.md` (Planned)
-4. Publish: `askill login && askill publish` (Planned)
+3. Validate: `askill validate`
+4. Publish: Push to GitHub, it's automatically indexed
 
 See [Publishing Guide](./docs/publishing.md) for details.
 
-### Building the CLI
-
-```bash
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Run locally
-node dist/cli.mjs --help
-```
-
-## Project Structure
-
-```
-askill/
-├── src/                    # CLI source code
-│   ├── cli.ts              # Main entry point
-│   ├── api.ts              # API client
-│   ├── installer.ts        # Skill installation
-│   ├── config.ts           # User preferences
-│   ├── updater.ts          # Self-update
-│   └── constants.ts        # Config and agent definitions
-├── docs/                   # Documentation
-│   ├── introduction.md     # Overview
-│   ├── getting-started.md  # Quick start
-│   ├── skill-spec.md       # SKILL.md protocol
-│   ├── slug-system.md      # Slug identification
-│   ├── publishing.md       # Publishing guide
-│   ├── cli-reference.md    # CLI commands
-│   └── api-spec.md         # REST API spec
-├── skills/                 # Official skills
-│   └── @askill/
-│       ├── agent/          # For using skills
-│       └── developer/      # For creating skills
-├── package.json
-├── tsconfig.json
-└── README.md
-```
-
-## Related Projects
-
-| Project | Description | Repository |
-|---------|-------------|------------|
-| askill (this repo) | CLI and documentation | [avibe-bot/askill](https://github.com/avibe-bot/askill) |
-| askill-registry | Web platform and API | [avibe-bot/askill-registry](https://github.com/avibe-bot/askill-registry) |
-
 ## Contributing
 
-Contributions are welcome! Please read our contributing guidelines before submitting PRs.
-
-### Development Setup
-
-```bash
-git clone https://github.com/avibe-bot/askill.git
-cd askill
-npm install
-npm run build
-```
-
-### Running Tests
-
-```bash
-npm test
-```
+We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
 
 ## License
 
@@ -251,4 +189,4 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 ---
 
-**Website**: [askill.sh](https://askill.sh) | **npm**: [@askill/cli](https://www.npmjs.com/package/@askill/cli)
+**Website**: [askill.sh](https://askill.sh) | **npm**: [askill-cli](https://www.npmjs.com/package/askill-cli) | **GitHub**: [avibe-bot/askill](https://github.com/avibe-bot/askill)

package/dist/cli.mjs

@@ -4,8 +4,9 @@
 import { homedir } from "os";
 import { join } from "path";
 import { existsSync } from "fs";
-var VERSION = "0.1.0";
+var VERSION = "0.1.2";
 var API_BASE_URL = "https://askill.sh/api/v1";
+var REGISTRY_URL = "https://askill.sh";
 var RESET = "\x1B[0m";
 var BOLD = "\x1B[1m";
 var DIM = "\x1B[2m";
@@ -766,7 +767,7 @@ async function checkForUpdates(force = false) {
     console.log();
     console.log(`${YELLOW}\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E${RESET}`);
     console.log(`${YELLOW}\u2502${RESET}  Update available: ${DIM}${current}${RESET} \u2192 ${GREEN}${latest}${RESET}        ${YELLOW}\u2502${RESET}`);
-    console.log(`${YELLOW}\u2502${RESET}  Run ${CYAN}askill self-update${RESET} to update         ${YELLOW}\u2502${RESET}`);
+    console.log(`${YELLOW}\u2502${RESET}  Run ${CYAN}askill upgrade${RESET} to update             ${YELLOW}\u2502${RESET}`);
     console.log(`${YELLOW}\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F${RESET}`);
     console.log();
   }
@@ -795,9 +796,9 @@ async function selfUpdate() {
   if (!downloadUrl) {
     console.log(`${RED}No download available for your platform (${platformKey})${RESET}`);
     console.log(`Please update manually:`);
-    console.log(`  ${CYAN}npm install -g @askill/cli@latest${RESET}`);
+    console.log(`  ${CYAN}curl -fsSL https://askill.sh | sh${RESET}`);
     console.log(`  ${DIM}or${RESET}`);
-    console.log(`  ${CYAN}curl -fsSL https://askill.sh/install.sh | sh${RESET}`);
+    console.log(`  ${CYAN}npm install -g askill-cli@latest${RESET}`);
     return false;
   }
   try {
@@ -805,7 +806,7 @@ async function selfUpdate() {
     const isNodeProcess = execPath.includes("node") || execPath.includes("bun");
     if (isNodeProcess) {
       console.log(`${YELLOW}Running via Node.js runtime${RESET}`);
-      console.log(`Please update using: ${CYAN}npm install -g @askill/cli@latest${RESET}`);
+      console.log(`Please update using: ${CYAN}npm install -g askill-cli@latest${RESET}`);
       return false;
     }
     const tempPath = `${execPath}.new`;
@@ -837,9 +838,9 @@ async function selfUpdate() {
   } catch (error) {
     console.log(`${RED}Update failed: ${error instanceof Error ? error.message : "Unknown error"}${RESET}`);
     console.log(`Please update manually:`);
-    console.log(`  ${CYAN}npm install -g @askill/cli@latest${RESET}`);
+    console.log(`  ${CYAN}curl -fsSL https://askill.sh | sh${RESET}`);
     console.log(`  ${DIM}or${RESET}`);
-    console.log(`  ${CYAN}curl -fsSL https://askill.sh/install.sh | sh${RESET}`);
+    console.log(`  ${CYAN}npm install -g askill-cli@latest${RESET}`);
     return false;
   }
 }
@@ -1474,7 +1475,7 @@ ${BOLD}Commands:${RESET}
   check                    Check installed skills for updates
   update [skill]           Update installed skills
   run <skill:cmd>          Run a skill command
-  self-update              Update askill CLI
+  upgrade                  Update askill CLI to latest version
 
 ${BOLD}Skill Source Formats:${RESET}
   owner/repo                          All skills from a GitHub repo
@@ -1967,6 +1968,9 @@ async function runSearch(args) {
       }
       const installCmd = skill.owner && skill.repo ? `gh:${skill.owner}/${skill.repo}@${displayName}` : `gh:${displayName}`;
       console.log(`  ${pc.dim("askill add")} ${installCmd}`);
+      if (skill.id) {
+        console.log(`  ${pc.dim(REGISTRY_URL + "/skills/" + skill.id)}`);
+      }
       console.log();
     }
     p.outro(`Browse more at ${pc.cyan("https://askill.sh")}`);
@@ -2779,10 +2783,9 @@ async function main() {
       await runCheck(restArgs);
       break;
     case "update":
-    case "upgrade":
       await runUpdate(restArgs);
       break;
-    case "self-update":
+    case "upgrade":
       await selfUpdate();
       break;
     case "run":

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "askill-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "askill - The Agent Skill Package Manager",
   "type": "module",
   "bin": {
-    "askill": "./dist/cli.mjs"
+    "askill": "dist/cli.mjs"
   },
   "files": [
     "dist",
@@ -37,7 +37,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/avibe-bot/askill.git"
+    "url": "git+https://github.com/avibe-bot/askill.git"
   },
   "homepage": "https://askill.sh",
   "author": "askill",