@skillsmanager/cli 0.0.4 → 0.0.5

package/dist/index.js

@@ -14,8 +14,11 @@ import { updateCommand } from "./commands/update.js";
 import { refreshCommand } from "./commands/refresh.js";
 import { setupGoogleCommand } from "./commands/setup/google.js";
 import { setupGithubCommand } from "./commands/setup/github.js";
+import { logoutGoogleCommand, logoutGithubCommand } from "./commands/logout.js";
 import { collectionCreateCommand } from "./commands/collection.js";
+import { skillDeleteCommand } from "./commands/skill.js";
 import { installCommand, uninstallCommand } from "./commands/install.js";
+import { statusCommand } from "./commands/status.js";
 import { registryCreateCommand, registryListCommand, registryDiscoverCommand, registryAddCollectionCommand, registryRemoveCollectionCommand, registryPushCommand, } from "./commands/registry.js";
 const supportedAgents = Object.keys(AGENT_PATHS).join(", ");
 // Read the bundled SKILL.md as the CLI help — single source of truth
@@ -44,7 +47,24 @@ setup
     .command("github")
     .description("One-time GitHub setup — checks gh CLI and runs gh auth login")
     .action(setupGithubCommand);
+// ── Logout ───────────────────────────────────────────────────────────────────
+const logout = program
+    .command("logout")
+    .description("Log out of a storage backend");
+logout
+    .command("google")
+    .description("Clear Google OAuth session (and optionally credentials)")
+    .option("--all", "Also remove credentials.json to start setup from scratch")
+    .action((options) => logoutGoogleCommand(options));
+logout
+    .command("github")
+    .description("Log out of GitHub (runs gh auth logout)")
+    .action(logoutGithubCommand);
 // ── Core commands ────────────────────────────────────────────────────────────
+program
+    .command("status")
+    .description("Show login status and identity for each backend")
+    .action(statusCommand);
 program
     .command("init")
     .description("Authenticate and discover collections (runs automatically when needed)")
@@ -64,10 +84,13 @@ program
     .option("--scope <scope>", "global (~/.agent/skills/) or project (./.agent/skills/)", "global")
     .action((names, options) => fetchCommand(names, options));
 program
-    .command("add <path>")
-    .description("Upload a local skill directory to a collection")
+    .command("add [path]")
+    .description("Upload a local skill directory to a collection, or register a remote path")
     .option("--collection <name>", "Target collection (default: first available)")
-    .action((skillPath, options) => addCommand(skillPath, options));
+    .option("--remote-path <rel/path>", "Register a skill path from the collection's skills-source repo (no local files needed)")
+    .option("--name <name>", "Skill name (required with --remote-path)")
+    .option("--description <desc>", "Skill description (used with --remote-path)")
+    .action((skillPath, options) => addCommand(skillPath ?? "", options));
 program
     .command("update <path>")
     .description("Push local edits to a skill back to storage and refresh cache")
@@ -77,6 +100,15 @@ program
     .command("refresh")
     .description("Re-discover collections from storage")
     .action(refreshCommand);
+// ── Skill ────────────────────────────────────────────────────────────────────
+const skill = program
+    .command("skill")
+    .description("Manage individual skills");
+skill
+    .command("delete <name>")
+    .description("Delete a single skill from a collection")
+    .option("--collection <name>", "Collection to delete from (required if skill is in multiple)")
+    .action((name, options) => skillDeleteCommand(name, options));
 // ── Collection ───────────────────────────────────────────────────────────────
 const collection = program
     .command("collection")
@@ -86,6 +118,7 @@ collection
     .description("Create a new collection (defaults to SKILLS_MY_SKILLS)")
     .option("--backend <backend>", "gdrive (default) or github", "gdrive")
     .option("--repo <owner/repo>", "GitHub repo to use (required for --backend github)")
+    .option("--skills-repo <owner/repo>", "GitHub repo where skills live (github backend only; defaults to --repo)")
     .action((name, options) => collectionCreateCommand(name, options));
 // ── Registry ─────────────────────────────────────────────────────────────────
 const registry = program
@@ -116,6 +149,7 @@ registry
     .command("remove-collection <name>")
     .description("Remove a collection reference from the registry")
     .option("--delete", "Also delete the collection and all its skills from the backend")
+    .option("--backend <backend>", "Backend the collection lives on (local, gdrive, github)")
     .action((name, options) => registryRemoveCollectionCommand(name, options));
 registry
     .command("push")

package/dist/registry.js

@@ -6,7 +6,7 @@ export const LEGACY_COLLECTION_FILENAME = "SKILLS_SYNC.yaml";
 // ── Collection (formerly "registry") parsing ─────────────────────────────────
 export function parseCollection(content) {
     const data = YAML.parse(content);
-    return {
+    const col = {
         name: data.name ?? "",
         owner: data.owner ?? "",
         skills: (data.skills ?? []).map((s) => ({
@@ -15,9 +15,13 @@ export function parseCollection(content) {
             description: s.description ?? "",
         })),
     };
+    if (data.metadata && typeof data.metadata === "object") {
+        col.metadata = data.metadata;
+    }
+    return col;
 }
 export function serializeCollection(collection) {
-    return YAML.stringify({
+    const obj = {
         name: collection.name,
         owner: collection.owner,
         skills: collection.skills.map((s) => ({
@@ -25,7 +29,11 @@ export function serializeCollection(collection) {
             path: s.path,
             description: s.description,
         })),
-    });
+    };
+    if (collection.metadata && Object.keys(collection.metadata).length > 0) {
+        obj.metadata = collection.metadata;
+    }
+    return YAML.stringify(obj);
 }
 // Backwards-compat aliases
 export const parseRegistry = parseCollection;

package/dist/types.d.ts

@@ -7,6 +7,7 @@ export interface CollectionFile {
     name: string;
     owner: string;
     skills: SkillEntry[];
+    metadata?: Record<string, unknown>;
 }
 export interface CollectionInfo {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillsmanager/cli",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Discover, fetch, and manage agent skills from local or remote storage",
   "type": "module",
   "bin": {
@@ -35,7 +35,7 @@
     "url": "git+https://github.com/talktoajayprakash/skillsmanager.git"
   },
   "author": "Ajay Prakash",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "homepage": "https://github.com/talktoajayprakash/skillsmanager#readme",
   "dependencies": {
     "chalk": "^4.1.2",

package/skills/skillsmanager/SKILL.md

@@ -11,6 +11,7 @@ Skills Manager is a CLI tool for managing agent skills stored locally or in remo
 
 - Local storage works out of the box — no setup needed.
 - For Google Drive: a human must run `skillsmanager setup google` once to configure credentials.
+- For GitHub: requires the `gh` CLI to be installed and authenticated (`gh auth login`). No additional skillsmanager setup needed.
 - All commands except `setup google` are non-interactive and designed for agent use.
 
 ## Commands
@@ -57,6 +58,16 @@ skillsmanager update <path> --collection <name>
 
 After updating, the local cache is refreshed so all symlinks on this machine reflect the change immediately.
 
+### Delete a skill
+
+```bash
+# Delete a skill from its collection (removes from backend, cache, and index)
+skillsmanager skill delete <name>
+
+# If the skill exists in multiple collections, specify which one
+skillsmanager skill delete <name> --collection <collection-name>
+```
+
 ### Registry and collection management
 
 ```bash
@@ -66,27 +77,37 @@ skillsmanager registry create
 # Create a registry in Google Drive
 skillsmanager registry create --backend gdrive
 
+# Create a registry in a GitHub repo (creates repo if it doesn't exist)
+skillsmanager registry create --backend github --repo <owner/repo>
+
 # Show all registries and their collection references
 skillsmanager registry list
 
 # Search a backend for registries owned by the current user
 skillsmanager registry discover --backend gdrive
+skillsmanager registry discover --backend github
 
 # Add a collection reference to the registry
 skillsmanager registry add-collection <name>
 
-# Push local registry and collections to Google Drive
+# Push local registry and collections to Google Drive (safe to re-run — skips already-synced collections)
 skillsmanager registry push --backend gdrive
 
+# Push local registry and collections to GitHub (safe to re-run — skips already-synced collections)
+skillsmanager registry push --backend github --repo <owner/repo>
+
 # Remove a collection reference from the registry (keeps data)
 skillsmanager registry remove-collection <name>
 
 # Remove and permanently delete the collection and all its skills
 skillsmanager registry remove-collection <name> --delete
 
-# Create a new collection
+# Create a new collection (local by default)
 skillsmanager collection create [name]
 
+# Create a collection in a GitHub repo
+skillsmanager collection create [name] --backend github --repo <owner/repo>
+
 # Re-discover collections from storage
 skillsmanager refresh
 ```
@@ -116,6 +137,9 @@ skillsmanager uninstall
 **User asks to share a skill they created:**
 1. Ensure the skill directory has a `SKILL.md` with `name` and `description` in YAML frontmatter
 2. `skillsmanager add <path-to-skill-directory>`
+3. Fetch the skill to make it immediately available to the agent:
+   - For all projects: `skillsmanager fetch <skill-name> --agent claude`
+   - For current project only: `skillsmanager fetch <skill-name> --agent claude --scope project`
 
 **User asks to update a skill:**
 1. Edit the skill files locally
@@ -128,9 +152,20 @@ skillsmanager uninstall
 1. `skillsmanager setup google` (one-time, human-only)
 2. `skillsmanager registry push --backend gdrive`
 
+**User wants to store skills in a GitHub repo:**
+1. `skillsmanager collection create <name> --backend github --repo <owner/repo>` — creates the GitHub repo if needed, and auto-registers the collection in the existing registry (or creates a local registry if none exists)
+2. `skillsmanager add <path> --collection <name>` — upload the skill into that collection
+
+**User wants to discover GitHub-hosted collections:**
+1. `skillsmanager registry discover --backend github`
+
 **User wants to see what registries and collections exist:**
 1. `skillsmanager registry list`
 
+**User asks to delete/remove a single skill:**
+1. `skillsmanager skill delete <skill-name>`
+2. If the skill lives in multiple collections, add `--collection <name>` to target the right one
+
 **User wants to remove a collection:**
 1. `skillsmanager registry remove-collection <name>` (removes reference only, data is kept)
 2. `skillsmanager registry remove-collection <name> --delete` (permanently deletes collection and skills)
@@ -139,7 +174,7 @@ skillsmanager uninstall
 
 - **Registry** (`SKILLS_REGISTRY.yaml`): root index pointing to all collections across backends
 - **Collection** (`SKILLS_COLLECTION.yaml`): folder of skills with an index file
-- **Backends**: `local` (default, `~/.skillsmanager/`) and `gdrive` (Google Drive)
+- **Backends**: `local` (default, `~/.skillsmanager/`), `gdrive` (Google Drive), and `github` (GitHub repo via `gh` CLI)
 - **Cache**: skills are cached at `~/.skillsmanager/cache/<uuid>/` and symlinked to agent directories
 - **Symlinks**: all agents share one cached copy — updating the cache updates all agents