skillup 0.5.0__tar.gz → 0.6.0__tar.gz

{skillup-0.5.0 → skillup-0.6.0}/.gitignore

@@ -8,3 +8,5 @@ wheels/
 
 # Virtual environments
 .venv
+.agents/skills
+.claude/skills

{skillup-0.5.0 → skillup-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillup
-Version: 0.5.0
+Version: 0.6.0
 Summary: A minimal CLI to manage agent skills from GitHub releases.
 License-File: LICENSE
 Requires-Python: >=3.11
@@ -9,6 +9,8 @@ Requires-Dist: requests
 Requires-Dist: rich
 Requires-Dist: truststore
 Requires-Dist: typer
+Provides-Extra: azure
+Requires-Dist: azure-identity>=1.16; extra == 'azure'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -18,11 +20,11 @@ Description-Content-Type: text/markdown
 <p align="center">
   <strong>Skill your agents up.</strong><br/>
   A minimal CLI to install, version, and sync skills for your AI agents.<br/>
-  Local-first · GitHub-backed · Works with Claude, Gemini, and more.
+  Local-first · GitHub &amp; Azure DevOps · Works with Claude, Gemini, and more.
 </p>
 
 <p align="center">
-  <code>pip install skillup</code> &nbsp;·&nbsp; <code>uv tool install skillup</code>
+  <code>uv tool install skillup</code>
 </p>
 
 ---
@@ -35,29 +37,69 @@ Description-Content-Type: text/markdown
 - **Auto-update** — upgrade all or specific repos to their latest release or branch head
 - **Smart cache** — skips redundant downloads; override with `SKILLUP_CACHE_DIR`
 - **gh integration** — uses `gh` CLI when available, falls back to `requests`
+- **Azure DevOps** — install skills from private Azure DevOps Git repos via `DefaultAzureCredential` or a PAT
 
 ## Installation
 
 ```bash
-pip install skillup
-# or
 uv tool install skillup
 ```
 
+To use Azure DevOps sources, install the `azure` extra:
+
+```bash
+uv tool install 'skillup[azure]'
+```
+
 ## Usage
 
-### Add skills
+### Add skills from GitHub
 
 ```bash
 skillup add google/gemini-cli-skills
 ```
 
-No releases? Falls back to `main` automatically. Pin a branch explicitly:
+No releases? Falls back to `main` automatically. Pin a branch or add specific skills non-interactively:
 
 ```bash
 skillup add anthropics/skills --branch main --skill pdf
 ```
 
+Full GitHub URLs are also accepted:
+
+```bash
+skillup add https://github.com/anthropics/skills
+```
+
+### Add skills from Azure DevOps
+
+Pass the full Azure DevOps clone URL — the provider is detected automatically from the domain:
+
+```bash
+skillup add https://dev.azure.com/myorg/myproject/_git/myrepo
+skillup add https://myorg.visualstudio.com/myproject/_git/myrepo   # legacy URL format
+
+# pin a branch or add specific skills non-interactively
+skillup add https://dev.azure.com/myorg/myproject/_git/myrepo --branch develop --skill my-skill
+```
+
+Azure DevOps repos are stored in the lock file under the key `azdo:org/project/repo` and participate in the shared `update` and `sync` commands just like GitHub repos.
+
+#### Authentication
+
+Authentication is resolved in this order:
+
+1. **`AZURE_DEVOPS_TOKEN` env var** — a Personal Access Token (PAT) with *Code → Read* scope, or any valid bearer token.
+2. **`DefaultAzureCredential`** (requires the `azure` extra) — tries, in order: environment variables (`AZURE_CLIENT_ID` / `AZURE_CLIENT_SECRET` / `AZURE_TENANT_ID`), workload identity, managed identity, Azure CLI (`az login`), Azure Developer CLI, and interactive browser login.
+
+The recommended approach for developer machines is `DefaultAzureCredential` via `az login`:
+
+```bash
+uv tool install 'skillup[azure]'
+az login
+skillup add https://dev.azure.com/myorg/myproject/_git/myrepo
+```
+
 ### Remove skills
 
 ```bash

skillup-0.6.0/README.md

@@ -0,0 +1,131 @@
+<p align="center">
+  <img src="assets/logo-wordmark.svg" alt="skillup" height="72" />
+</p>
+
+<p align="center">
+  <strong>Skill your agents up.</strong><br/>
+  A minimal CLI to install, version, and sync skills for your AI agents.<br/>
+  Local-first · GitHub &amp; Azure DevOps · Works with Claude, Gemini, and more.
+</p>
+
+<p align="center">
+  <code>uv tool install skillup</code>
+</p>
+
+---
+
+## Features
+
+- **Interactive install** — pick skills from any GitHub repo release
+- **Multi-repo** — manage skills from multiple sources independently
+- **Lock file** — pins commit SHAs for reproducible installs (`~/.agents/skills.lock.json`)
+- **Auto-update** — upgrade all or specific repos to their latest release or branch head
+- **Smart cache** — skips redundant downloads; override with `SKILLUP_CACHE_DIR`
+- **gh integration** — uses `gh` CLI when available, falls back to `requests`
+- **Azure DevOps** — install skills from private Azure DevOps Git repos via `DefaultAzureCredential` or a PAT
+
+## Installation
+
+```bash
+uv tool install skillup
+```
+
+To use Azure DevOps sources, install the `azure` extra:
+
+```bash
+uv tool install 'skillup[azure]'
+```
+
+## Usage
+
+### Add skills from GitHub
+
+```bash
+skillup add google/gemini-cli-skills
+```
+
+No releases? Falls back to `main` automatically. Pin a branch or add specific skills non-interactively:
+
+```bash
+skillup add anthropics/skills --branch main --skill pdf
+```
+
+Full GitHub URLs are also accepted:
+
+```bash
+skillup add https://github.com/anthropics/skills
+```
+
+### Add skills from Azure DevOps
+
+Pass the full Azure DevOps clone URL — the provider is detected automatically from the domain:
+
+```bash
+skillup add https://dev.azure.com/myorg/myproject/_git/myrepo
+skillup add https://myorg.visualstudio.com/myproject/_git/myrepo   # legacy URL format
+
+# pin a branch or add specific skills non-interactively
+skillup add https://dev.azure.com/myorg/myproject/_git/myrepo --branch develop --skill my-skill
+```
+
+Azure DevOps repos are stored in the lock file under the key `azdo:org/project/repo` and participate in the shared `update` and `sync` commands just like GitHub repos.
+
+#### Authentication
+
+Authentication is resolved in this order:
+
+1. **`AZURE_DEVOPS_TOKEN` env var** — a Personal Access Token (PAT) with *Code → Read* scope, or any valid bearer token.
+2. **`DefaultAzureCredential`** (requires the `azure` extra) — tries, in order: environment variables (`AZURE_CLIENT_ID` / `AZURE_CLIENT_SECRET` / `AZURE_TENANT_ID`), workload identity, managed identity, Azure CLI (`az login`), Azure Developer CLI, and interactive browser login.
+
+The recommended approach for developer machines is `DefaultAzureCredential` via `az login`:
+
+```bash
+uv tool install 'skillup[azure]'
+az login
+skillup add https://dev.azure.com/myorg/myproject/_git/myrepo
+```
+
+### Remove skills
+
+```bash
+skillup remove
+```
+
+### Update skills
+
+```bash
+skillup update                              # all repos
+skillup update --repo google/gemini-cli-skills  # one repo
+```
+
+### Sync (restore from lock file)
+
+```bash
+skillup sync
+```
+
+Installs skills at the exact pinned SHAs from the lock file — useful for new machines.
+
+### Migrate from NPX skills CLI
+
+```bash
+skillup migrate                       # reads skills-lock.json from repo root
+skillup migrate path/to/skills-lock.json
+```
+
+## Skill definition
+
+A folder is recognized as a skill when it lives inside a `skills/` directory at the repo root and contains a `SKILL.md` file.
+
+## Development
+
+```bash
+uv sync          # install deps
+uv run skillup --help
+uv run pytest
+uv run pyright skillup
+```
+
+## License
+
+MIT

{skillup-0.5.0 → skillup-0.6.0}/docs/commands.md

@@ -1,13 +1,60 @@
 # Commands
 
-## Global flag
+## Global options
 
-All commands accept a `--global` / `-g` flag that switches the lock file and base directory to your home directory instead of the current working directory.
+All commands accept these options before the subcommand name:
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--global` | `-g` | Use home directory instead of current working directory. |
+| `--lock-file PATH` | `-l` | Use a custom lock file path instead of the default. |
 
 ```bash
 skillup --global add myorg/skills
+skillup --lock-file /path/to/my.lock.json sync
+```
+
+---
+
+## `config`
+
+Manage skillup configuration. Settings are persisted in the lock file.
+
+### `config set-dirs`
+
+Set the target directories where skills are installed.
+
+```bash
+skillup config set-dirs <DIR> [DIR...]
+```
+
+**Examples**
+
+```bash
+# Replace the two defaults with a single custom directory
+skillup config set-dirs /home/user/my-skills
+
+# Use custom paths for both agent frameworks
+skillup config set-dirs .agents/skills .vscode/skills
+```
+
+**Behavior**
+
+- Accepts one or more directory paths (space-separated).
+- Paths can be absolute or relative (resolved from the current working directory).
+- Saves the directories to the `config.target_dirs` key in the lock file.
+- All subsequent commands (`add`, `remove`, `update`, `sync`) install to and remove from these directories.
+
+### `config show`
+
+Display the current configuration.
+
+```bash
+skillup config show
 ```
 
+Shows the active lock file path and target directories, including whether each was read from the lock file or is the built-in default.
+
 ---
 
 ## `add`
@@ -22,13 +69,17 @@ skillup add <owner/repo> [OPTIONS]
 |--------|-------|-------------|
 | `--skill TEXT` | `-s` | Skill name to add (repeatable). Skips interactive picker. |
 | `--branch TEXT` | `-b` | Install from this branch instead of the latest release. |
+| `--search TEXT` | `-f` | Filter the interactive tree to skills whose name or path contains TEXT (case-insensitive). |
 
 **Examples**
 
 ```bash
-# Interactive picker — choose from all available skills
+# Interactive picker — browse the full skill tree
 skillup add google/gemini-cli-skills
 
+# Filter the tree to skills related to "python"
+skillup add myorg/skills --search python
+
 # Add one skill non-interactively
 skillup add anthropics/skills --skill pdf
 
@@ -39,6 +90,28 @@ skillup add anthropics/skills --skill pdf --skill code-review
 skillup add myorg/skills --branch main
 ```
 
+**Interactive tree picker**
+
+Without `--skill`, `skillup add` opens an interactive tree that mirrors the repository's directory structure:
+
+```
+Select skills to add from myorg/skills:
+  > docs/  [2 skills]
+      getting-started
+      reference
+    tools/  [3 skills]
+      linter
+      formatter
+      test-runner
+
+↑↓ move  Space toggle  Enter confirm  Ctrl-C cancel
+```
+
+- **Space** on a directory selects or deselects every skill beneath it.
+- Directory entries show a tri-state indicator: `[ ]` none, `[-]` partial, `[x]` all selected.
+- **Space** on an individual skill toggles just that skill and updates the parent's indicator.
+- Use `--search` to narrow the tree before the picker opens.
+
 **Behavior**
 
 - Fetches the latest GitHub release. If none exists, falls back to `main`.

{skillup-0.5.0 → skillup-0.6.0}/docs/lock-file.md

@@ -10,6 +10,9 @@ skillup tracks installed skills in a lock file at:
 
 ```json
 {
+  "config": {
+    "target_dirs": ["/custom/agents/skills", "/custom/claude/skills"]
+  },
   "repos": {
     "google/gemini-cli-skills": {
       "skills": ["code-review", "pdf"],
@@ -27,7 +30,15 @@ skillup tracks installed skills in a lock file at:
 }
 ```
 
-## Fields
+The `config` section is optional and only written when you change settings from their defaults via `skillup config set-dirs`.
+
+## Fields — `config`
+
+| Field | Description |
+|-------|-------------|
+| `config.target_dirs` | List of directories where skills are installed. Omitted when using the built-in defaults. |
+
+## Fields — `repos`
 
 | Field | Description |
 |-------|-------------|
@@ -51,4 +62,10 @@ skillup sync
 
 ## Location override
 
-The `--global` flag switches the base directory (and therefore the lock file location) to your home directory. Without it, skillup uses the current working directory.
+The `--global` / `-g` flag switches the base directory (and therefore the lock file location) to your home directory. Without it, skillup uses the current working directory.
+
+For full control over the lock file path, use `--lock-file` / `-l`:
+
+```bash
+skillup --lock-file /shared/team.lock.json sync
+```

{skillup-0.5.0 → skillup-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "skillup"
-version = "0.5.0"
+version = "0.6.0"
 description = "A minimal CLI to manage agent skills from GitHub releases."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -16,6 +16,9 @@ dependencies = [
     "truststore",
 ]
 
+[project.optional-dependencies]
+azure = ["azure-identity>=1.16"]
+
 [dependency-groups]
 dev = [
     "pyright",

skillup-0.6.0/skillup/_tree_ui.py

@@ -0,0 +1,169 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from prompt_toolkit import Application
+from prompt_toolkit.key_binding import KeyBindings
+from prompt_toolkit.layout import Layout
+from prompt_toolkit.layout.containers import Window
+from prompt_toolkit.layout.controls import FormattedTextControl
+from prompt_toolkit.styles import Style
+
+
+@dataclass
+class Node:
+    label: str
+    value: str        # "__dir__:path" or skill_name
+    depth: int
+    checked: bool = False
+    parent: int = -1  # index in flat list; -1 = top-level
+    children: list[int] = field(default_factory=list)
+
+    @property
+    def is_dir(self) -> bool:
+        return self.value.startswith("__dir__:")
+
+
+def _count_in_subtree(t: dict) -> int:
+    return len(t.get("_skills", [])) + sum(
+        _count_in_subtree(v) for k, v in t.items() if k != "_skills"
+    )
+
+
+def build_flat_nodes(skill_paths: dict[str, str]) -> list[Node]:
+    """Return a DFS-ordered flat list of Nodes from {skill_name: repo-relative-path}."""
+    tree: dict = {}
+    for skill_name, path in skill_paths.items():
+        parts = path.split("/")
+        node = tree
+        for part in parts[:-1]:
+            node = node.setdefault(part, {})
+        node.setdefault("_skills", []).append(skill_name)
+
+    nodes: list[Node] = []
+
+    def flatten(subtree: dict, prefix: str, depth: int, parent_idx: int) -> None:
+        for dir_name in sorted(k for k in subtree if k != "_skills"):
+            dir_path = f"{prefix}/{dir_name}" if prefix else dir_name
+            n = _count_in_subtree(subtree[dir_name])
+            s = "s" if n != 1 else ""
+            dir_idx = len(nodes)
+            if parent_idx >= 0:
+                nodes[parent_idx].children.append(dir_idx)
+            nodes.append(Node(
+                label=f"{dir_name}/  [{n} skill{s}]",
+                value=f"__dir__:{dir_path}",
+                depth=depth,
+                parent=parent_idx,
+            ))
+            flatten(subtree[dir_name], dir_path, depth + 1, dir_idx)
+
+        for skill in sorted(subtree.get("_skills", [])):
+            skill_idx = len(nodes)
+            if parent_idx >= 0:
+                nodes[parent_idx].children.append(skill_idx)
+            nodes.append(Node(
+                label=skill,
+                value=skill,
+                depth=depth,
+                parent=parent_idx,
+            ))
+
+    flatten(tree, "", 0, -1)
+    return nodes
+
+
+def dir_state(idx: int, nodes: list[Node]) -> str:
+    """Return 'all', 'some', or 'none' for a dir node based on its descendants."""
+    node = nodes[idx]
+    if not node.children:
+        return "all" if node.checked else "none"
+    checked = sum(
+        1 for c in node.children
+        if (nodes[c].is_dir and dir_state(c, nodes) == "all")
+        or (not nodes[c].is_dir and nodes[c].checked)
+    )
+    if checked == 0:
+        return "none"
+    if checked == len(node.children):
+        return "all"
+    return "some"
+
+
+def _set_subtree(idx: int, nodes: list[Node], checked: bool) -> None:
+    nodes[idx].checked = checked
+    for c in nodes[idx].children:
+        _set_subtree(c, nodes, checked)
+
+
+def toggle(idx: int, nodes: list[Node]) -> None:
+    """Toggle a node. Dirs toggle their entire subtree; check-all if not all checked."""
+    if nodes[idx].is_dir:
+        _set_subtree(idx, nodes, dir_state(idx, nodes) != "all")
+    else:
+        nodes[idx].checked = not nodes[idx].checked
+
+
+def tree_checkbox(prompt: str, skill_paths: dict[str, str]) -> list[str] | None:
+    """Interactive hierarchical checkbox.
+
+    Space on a directory selects/deselects every skill beneath it.
+    Directories show tri-state: [ ] none, [-] partial, [x] all.
+
+    Returns sorted skill names, or None if the user cancelled.
+    """
+    nodes = build_flat_nodes(skill_paths)
+    if not nodes:
+        return []
+
+    state = {"cursor": 0, "cancelled": False}
+
+    def get_tokens() -> list[tuple[str, str]]:
+        lines: list[tuple[str, str]] = [("class:prompt", f"{prompt}\n")]
+        for i, node in enumerate(nodes):
+            indent = "  " * node.depth
+            if node.is_dir:
+                s = dir_state(i, nodes)
+                cb = "[x]" if s == "all" else "[-]" if s == "some" else "[ ]"
+            else:
+                cb = "[x]" if node.checked else "[ ]"
+            marker = "> " if i == state["cursor"] else "  "
+            style = "class:cursor" if i == state["cursor"] else ""
+            lines.append((style, f"{marker}{indent}{cb} {node.label}\n"))
+        lines.append(("class:hint", "\n↑↓ move  Space toggle  Enter confirm  Ctrl-C cancel\n"))
+        return lines
+
+    kb = KeyBindings()
+
+    @kb.add("up")
+    def _(e): state["cursor"] = max(0, state["cursor"] - 1)
+
+    @kb.add("down")
+    def _(e): state["cursor"] = min(len(nodes) - 1, state["cursor"] + 1)
+
+    @kb.add("space")
+    def _(e): toggle(state["cursor"], nodes)
+
+    @kb.add("enter")
+    def _(e): e.app.exit()
+
+    @kb.add("c-c")
+    def _(e):
+        state["cancelled"] = True
+        e.app.exit()
+
+    app = Application(
+        layout=Layout(Window(FormattedTextControl(get_tokens, focusable=True))),
+        key_bindings=kb,
+        style=Style.from_dict({
+            "cursor": "reverse",
+            "prompt": "bold",
+            "hint": "fg:ansigray italic",
+        }),
+        mouse_support=False,
+    )
+    app.run()
+
+    if state["cancelled"]:
+        return None
+    return sorted(n.value for n in nodes if not n.is_dir and n.checked)