skilldex-cli 0.1.0

package/dist/registry/sources/github.d.ts

@@ -0,0 +1,10 @@
+import type { ScopeConfig } from '../../types/scope.js';
+import type { InstallOptions, InstallResult } from '../../core/installer.js';
+export interface ParsedGitUrl {
+    repoUrl: string;
+    branch?: string;
+    subPath?: string;
+}
+export declare function parseGitUrl(raw: string): ParsedGitUrl;
+export declare function installFromGitUrl(rawUrl: string, targetScopeConfig: ScopeConfig, options: InstallOptions): Promise<InstallResult>;
+//# sourceMappingURL=github.d.ts.map

package/dist/registry/sources/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/registry/sources/github.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAG5E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAerD;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,WAAW,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA6BxB"}

package/dist/registry/sources/github.js

@@ -0,0 +1,78 @@
+import { mkdtemp, rm, readdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { simpleGit } from 'simple-git';
+import { installFromPath } from '../../core/installer.js';
+export function parseGitUrl(raw) {
+    // Remove git+ prefix
+    let url = raw.replace(/^git\+/, '');
+    // Handle tree/branch/path syntax: https://github.com/user/repo/tree/branch/path
+    const treeMatch = url.match(/^(https?:\/\/[^/]+\/[^/]+\/[^/]+)\/tree\/([^/]+)(\/.*)?$/);
+    if (treeMatch) {
+        return {
+            repoUrl: treeMatch[1],
+            branch: treeMatch[2],
+            subPath: treeMatch[3]?.replace(/^\//, ''),
+        };
+    }
+    return { repoUrl: url };
+}
+export async function installFromGitUrl(rawUrl, targetScopeConfig, options) {
+    const parsed = parseGitUrl(rawUrl);
+    const tmpDir = await mkdtemp(path.join(os.tmpdir(), 'skilldex-'));
+    try {
+        const git = simpleGit();
+        const cloneOptions = parsed.branch ? ['--branch', parsed.branch, '--depth', '1'] : ['--depth', '1'];
+        await git.clone(parsed.repoUrl, tmpDir, cloneOptions);
+        const searchRoot = parsed.subPath ? path.join(tmpDir, parsed.subPath) : tmpDir;
+        // Find skill folders (directories containing SKILL.md)
+        const skillFolders = await findSkillFolders(searchRoot);
+        if (skillFolders.length === 0) {
+            throw new Error(`No skill folders (directories with SKILL.md) found in ${rawUrl}`);
+        }
+        // If exactly one skill found, install it directly
+        if (skillFolders.length === 1) {
+            return installFromPath(skillFolders[0], { ...options, sourceUrl: rawUrl });
+        }
+        // Multiple skills — install all (or first, for simplicity in MVP)
+        // TODO: In a future version, prompt the user to select which ones
+        return installFromPath(skillFolders[0], { ...options, sourceUrl: rawUrl });
+    }
+    finally {
+        await rm(tmpDir, { recursive: true, force: true });
+    }
+}
+async function findSkillFolders(root) {
+    const results = [];
+    // Check if root itself is a skill folder
+    try {
+        await stat(path.join(root, 'SKILL.md'));
+        results.push(root);
+        return results;
+    }
+    catch {
+        // root is not a skill folder itself — search children
+    }
+    try {
+        const entries = await readdir(root, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith('.'))
+                continue;
+            const childPath = path.join(root, entry.name);
+            try {
+                await stat(path.join(childPath, 'SKILL.md'));
+                results.push(childPath);
+            }
+            catch {
+                // not a skill folder
+            }
+        }
+    }
+    catch {
+        // Can't read directory
+    }
+    return results;
+}
+//# sourceMappingURL=github.js.map

package/dist/registry/sources/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../src/registry/sources/github.ts"],"names":[],"mappings":"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"}

package/dist/types/manifest.d.ts

@@ -0,0 +1,19 @@
+import type { ScopeLevel } from './scope.js';
+export type SkillSource = 'official' | 'community' | 'local';
+export interface InstalledSkill {
+    name: string;
+    version: string;
+    source: SkillSource;
+    sourceUrl?: string;
+    installedAt: string;
+    specVersion: string;
+    score: number;
+    path: string;
+}
+export interface SkillManifest {
+    skilldexVersion: string;
+    scope: ScopeLevel;
+    skills: Record<string, InstalledSkill>;
+    updatedAt: string;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/types/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACtC,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/types/manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/types/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":""}

package/dist/types/registry.d.ts

@@ -0,0 +1,17 @@
+import type { SkillSource } from './manifest.js';
+export interface RegistryEntry {
+    name: string;
+    description: string;
+    source: SkillSource;
+    sourceUrl: string;
+    score: number;
+    specVersion: string;
+    tags: string[];
+    publishedAt: string;
+}
+export interface SearchResult {
+    entries: RegistryEntry[];
+    query: string;
+    total: number;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/types/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd"}

package/dist/types/registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/types/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":""}

package/dist/types/scope.d.ts

@@ -0,0 +1,8 @@
+export type ScopeLevel = 'global' | 'shared' | 'project';
+export interface ScopeConfig {
+    level: ScopeLevel;
+    rootPath: string;
+    manifestPath: string;
+    skillsDir: string;
+}
+//# sourceMappingURL=scope.d.ts.map

package/dist/types/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/types/scope.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAExD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/types/scope.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope.js.map

package/dist/types/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/types/scope.ts"],"names":[],"mappings":""}

package/dist/types/skill.d.ts

@@ -0,0 +1,34 @@
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    version?: string;
+    tags?: string[];
+    author?: string;
+    specVersion?: string;
+}
+export interface SkillPackage {
+    name: string;
+    path: string;
+    frontmatter: SkillFrontmatter;
+    lineCount: number;
+    hasScripts: boolean;
+    hasReferences: boolean;
+    hasAssets: boolean;
+}
+export type ValidationSeverity = 'error' | 'warning' | 'pass';
+export interface ValidationDiagnostic {
+    severity: ValidationSeverity;
+    line?: number;
+    message: string;
+    check: string;
+}
+export interface ValidationResult {
+    skill: string;
+    score: number;
+    diagnostics: ValidationDiagnostic[];
+    specVersion: string;
+    passCount: number;
+    warnCount: number;
+    errorCount: number;
+}
+//# sourceMappingURL=skill.d.ts.map

package/dist/types/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/types/skill.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,gBAAgB,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,oBAAoB,EAAE,CAAA;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/dist/types/skill.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill.js.map

package/dist/types/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/types/skill.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "skilldex-cli",
+  "version": "0.1.0",
+  "description": "Package manager and registry for Claude skill packages",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "skillpm": "./dist/index.js",
+    "spm": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src tests",
+    "format": "prettier --write src tests",
+    "dev": "tsx src/index.ts",
+    "mcp": "node dist/mcp/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.51.0",
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "inquirer": "^12.5.2",
+    "ora": "^8.2.0",
+    "simple-git": "^3.33.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.30",
+    "@vitest/coverage-v8": "^3.1.1",
+    "eslint": "^9.24.0",
+    "prettier": "^3.5.3",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+  "type": "git",
+  "url": "https://github.com/Pandemonium-Research/Skilldex"
+  },
+  "keywords": ["claude", "skills", "package-manager", "anthropic", "ai"]
+}