skill-mix 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# Skills Manager
+
+A management layer for AI agent skills — discover, install, scope, rate, and update skills across Cursor, Codex, and Claude Code.
+
+All three tools follow the open [Agent Skills](https://agentskills.io/) standard (`SKILL.md`), but none solves the management problem: how to find the right skill, avoid duplicates, track where it came from, or know if it's any good.
+
+## Setup
+
+Quick install Skills Manager, open the app, and launch the skill-picker modal:
+
+```bash
+npx -y skill-mix obra/superpowers
+```
+
+Preselect specific skills before the modal opens:
+
+```bash
+npx -y skill-mix obra/superpowers workflow research
+```
+
+Classic installer:
+
+```
+curl -fsSL https://raw.githubusercontent.com/razbakov/skills-manager/main/scripts/install.sh | bash
+```
+
+## Usage
+
+Run `skills` to launch application
+
+Open/focus the app and trigger the skill-picker from CLI:
+
+```bash
+skills set <owner/repo|github-url> [skill ...]
+```
+
+![Skills Manager desktop UI](docs/images/desktop-ui.png)
+
+## Build DMG (macOS)
+
+```
+bun install
+bun run dist:dmg
+```
+
+This outputs a DMG installer in `release/`.
+
+## Problem
+
+See **[Research](docs/research.md)** for how tools handle skills today, **[User Problems](docs/problems.md)** for 14 documented pain points, **[Landscape](docs/landscape.md)** for existing directories and tools, and **[Competitors](docs/competitors.md)** for detailed analysis of current solutions and their gaps.
+
+- **Naming collisions** — Multiple skills share similar names or overlap in responsibility. Cursor has no detection; Codex shows both without merging; Claude Code overrides by scope precedence.
+- **No development workflow** — No way to test, enable, or disable skills without editing files by hand (Codex has `config.toml`, but no UI).
+- **Unknown provenance** — None of the three tools track where a skill came from, who wrote it, or how to update it.
+- **Scattered collections** — Skills live in 3–6 different directories per tool with no unified view.
+- **No quality signals** — No ratings, benchmarks, or reviews exist anywhere in the ecosystem.
+
+## Key Features
+
+- **[Skill Registry](docs/registry.md)**: Search, browse, and install skills from a shared catalog with deduplication and conflict detection.
+- **[Scope Management](docs/scopes.md)**: Enable or disable skills at three levels — personal, organization, and project — with clear precedence rules across all supported tools.
+- **[Provenance Tracking](docs/provenance.md)**: Every skill records its source repo, author, version, and update channel.
+- **[Quality Scores](docs/quality.md)**: Community and automated ratings for security, efficiency, and best practices, with benchmarks across models and harnesses.
+- **[Development Mode](docs/dev-mode.md)**: GUI for authoring, testing, and previewing skills before publishing.

package/bin/skills

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SOURCE_PATH="${BASH_SOURCE[0]}"
+while [ -L "${SOURCE_PATH}" ]; do
+  SOURCE_DIR="$(cd -P -- "$(dirname -- "${SOURCE_PATH}")" && pwd)"
+  LINK_TARGET="$(readlink "${SOURCE_PATH}")"
+  if [[ "${LINK_TARGET}" == /* ]]; then
+    SOURCE_PATH="${LINK_TARGET}"
+  else
+    SOURCE_PATH="${SOURCE_DIR}/${LINK_TARGET}"
+  fi
+done
+
+SCRIPT_DIR="$(cd -P -- "$(dirname -- "${SOURCE_PATH}")" && pwd)"
+
+resolve_bun() {
+  if command -v bun >/dev/null 2>&1; then
+    command -v bun
+    return 0
+  fi
+
+  if [ -n "${BUN_INSTALL:-}" ] && [ -x "${BUN_INSTALL%/}/bin/bun" ]; then
+    echo "${BUN_INSTALL%/}/bin/bun"
+    return 0
+  fi
+
+  if [ -x "${HOME}/.bun/bin/bun" ]; then
+    echo "${HOME}/.bun/bin/bun"
+    return 0
+  fi
+
+  echo "Unable to find Bun. Install Bun and ensure it is available on PATH: https://bun.sh/" >&2
+  exit 1
+}
+
+BUN_BIN="$(resolve_bun)"
+exec "${BUN_BIN}" "${SCRIPT_DIR}/../src/index.ts" "$@"

package/bin/skills-manager

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SOURCE_PATH="${BASH_SOURCE[0]}"
+while [ -L "${SOURCE_PATH}" ]; do
+  SOURCE_DIR="$(cd -P -- "$(dirname -- "${SOURCE_PATH}")" && pwd)"
+  LINK_TARGET="$(readlink "${SOURCE_PATH}")"
+  if [[ "${LINK_TARGET}" == /* ]]; then
+    SOURCE_PATH="${LINK_TARGET}"
+  else
+    SOURCE_PATH="${SOURCE_DIR}/${LINK_TARGET}"
+  fi
+done
+
+SCRIPT_DIR="$(cd -P -- "$(dirname -- "${SOURCE_PATH}")" && pwd)"
+INSTALL_SCRIPT="${SCRIPT_DIR}/../scripts/install.sh"
+
+if [ "$#" -eq 0 ]; then
+  echo "Usage: npx -y skill-mix <owner/repo|github-url> [skill ...]" >&2
+  exit 1
+fi
+
+"${INSTALL_SCRIPT}"
+
+if [ -n "${SKILLS_MANAGER_GLOBAL_BIN_DIR:-}" ]; then
+  SKILLS_CMD_PATH="${SKILLS_MANAGER_GLOBAL_BIN_DIR%/}/skills"
+elif [ -n "${BUN_INSTALL:-}" ]; then
+  SKILLS_CMD_PATH="${BUN_INSTALL%/}/bin/skills"
+else
+  SKILLS_CMD_PATH="${HOME}/.bun/bin/skills"
+fi
+
+if [ -x "${SKILLS_CMD_PATH}" ]; then
+  exec "${SKILLS_CMD_PATH}" set "$@"
+fi
+
+if command -v skills >/dev/null 2>&1; then
+  exec "$(command -v skills)" set "$@"
+fi
+
+echo "Skills Manager was installed, but 'skills' command is unavailable." >&2
+exit 1