skill-control-plane 1.0.1__tar.gz

skill_control_plane-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 skills-manager contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skill_control_plane-1.0.1/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: skill-control-plane
+Version: 1.0.1
+Summary: Local control plane for AI coding-agent skills: manage SKILL.md across agents from one CLI + web UI
+Author: skills-manager contributors
+License: MIT
+Project-URL: Homepage, https://github.com/udayvarmora07/skills-manager
+Project-URL: Repository, https://github.com/udayvarmora07/skills-manager
+Project-URL: Issues, https://github.com/udayvarmora07/skills-manager/issues
+Project-URL: Documentation, https://github.com/udayvarmora07/skills-manager#readme
+Project-URL: Changelog, https://github.com/udayvarmora07/skills-manager/blob/main/CHANGELOG.md
+Keywords: ai-agents,agent-skills,skill-management,cli,claude-code,cursor,opencode
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# skills-manager
+
+**The local control plane for your AI coding-agent skills.** Create, organize, sync, back up, and quality-check `SKILL.md` skills across every agent you use — from one CLI and one local web UI.
+
+[![CI](https://github.com/udayvarmora07/skills-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/udayvarmora07/skills-manager/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg)](pyproject.toml)
+
+> `skills-manager` on GitHub: `udayvarmora07/skills-manager`. PyPI badge tracks a future release: `skill-control-plane` is not on PyPI yet, so install from source or `pip install` the CI-built wheel/sdist below. Distribution name `skill-control-plane` (`skills-mgr` entry point) is reserved for that release.
+
+## Why this exists
+
+The [Agent Skills](https://agentskills.io) format (`SKILL.md`) is now an open standard supported by Claude Code, Cursor, Gemini CLI, OpenCode, Copilot/VS Code, Goose, Amp, and more. The ecosystem has **skill libraries** ([vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)), **installers** ([skills.sh](https://skills.sh)), and a **spec** — but nobody owns the *management* problem:
+
+- The same skill copy-pasted into `~/.claude/skills`, `~/.codex/skills`, Cursor dirs… edits diverge.
+- Vague descriptions cause false activation or misses; oversized bodies eat context.
+- No versioning, no safe update/rollback, no backup story, no cross-tool view.
+
+`skills-manager` fills that gap: one store, every scope, full lifecycle.
+
+| | skills-manager | `skills.sh` / `npx skills add` | skill libraries |
+|---|---|---|---|
+| Install remote skills | ✅ (via `install`) | ✅ | — (source) |
+| Create / edit / validate locally | ✅ | — | — |
+| Manage across **all** your agents | ✅ (`--scope all`) | single-target | — |
+| Sync + dedup between agents | ✅ | — | — |
+| Version history + trash/rollback | ✅ | — | — |
+| Token-footprint budgeting | ✅ (`tokens`) | — | — |
+| Local web UI | ✅ | — | — |
+
+## Install
+
+Requires Python ≥ 3.10. The runtime is **stdlib-only** — no dependencies.
+
+PyPI is not published yet (see `.github/workflows/release.yml` for the
+controlled Trusted Publishing path). Until the first GitHub Release lands:
+
+```bash
+pipx install skill-control-plane        # recommended (isolated)
+# or
+pip install skill-control-plane
+```
+
+Run without installing:
+
+```bash
+git clone https://github.com/udayvarmora07/skills-manager
+cd skills-manager
+python3 -m skillsmgr --help
+```
+
+## Quickstart
+
+```bash
+# 1. See everything you have, everywhere
+skills-mgr list --scope all
+
+# 2. Create a skill once…
+skills-mgr create my-workflow -d "Deploys our staging stack. Use when shipping to staging."
+
+# 3. …sync it to every agent you use
+skills-mgr sync my-workflow
+
+# 4. Or manage it visually (localhost only, no build step, works offline)
+skills-mgr webui
+```
+
+More:
+
+```bash
+skills-mgr search "deploy" --scope all   # scored search across agents
+skills-mgr tokens --scope all            # context-footprint budgeting
+skills-mgr validate --all                # spec lint incl. description/body guidance
+skills-mgr export                        # timestamped backup tarball
+skills-mgr install vercel-labs/agent-skills --dry-run   # preview remote install
+```
+
+## Agent scopes
+
+One command surface, per-agent directories underneath:
+
+| Scope | Directory |
+|---|---|
+| `global` (default) | manager store (`~/.local/share/skills-manager/skills/`) |
+| `claude-code` | `~/.claude/skills` |
+| `codex` | `~/.codex/skills` |
+| `cursor` | `~/.cursor/skills` |
+| `opencode` | `~/.config/opencode/skills` |
+| `gemini` | `~/.gemini/skills` |
+| `commandcode` | `~/.commandcode/skills` |
+| `agents` | `~/.agents/skills` |
+| `all` | merged read-only view |
+
+`list`, `view`, `search`, `doctor`, `stats` accept `--scope`; `sync` copies between scopes; `tokens`/`install` have their own scope semantics. Agent-scope writes go straight to the agent dir (no DB) — disable renames `SKILL.md` ⇄ `SKILL.md.disabled` in place, which Claude Code and Command Code both respect.
+
+## Web UI
+
+```bash
+skills-mgr webui              # http://127.0.0.1:8765, opens browser
+skills-mgr webui --no-browser # server only
+skills-mgr webui --port 9000  # custom port
+```
+
+Stdlib `ThreadingHTTPServer` backend + vendored Vue 3 (no npm, no CDN, works offline). Scope switcher, live search, trash with undo, validate/doctor/stats/history, templates, tar export plus tar/ZIP import, sync modal. Binds loopback only — never expose it; there is no auth (see [Threat model](skills-manager-threat-model.md)).
+
+## Data model
+
+- **Filesystem is the source of truth**: `<data>/skills/<name>/SKILL.md`.
+- **SQLite is a rebuildable index only** (`db rebuild` / `db resync` repair any drift; never hand-edit it).
+- Data dir: `$SKILLS_MANAGER_DATA` → `$XDG_DATA_HOME` → `~/.local/share`, then `/skills-manager`.
+
+## CLI reference
+
+37 invocable names: 27 top-level commands + 7 `trash`/`templates`/`db` subcommands + 3 `ls`/`rm`/`gui` aliases. Exit codes: `0` ok · `1` error · `2` usage · `130` interrupt. `--json` on data commands.
+
+Full surface: [`docs/03-cli-surface.md`](docs/03-cli-surface.md).
+
+## Contributing
+
+PRs welcome — start with [`CONTRIBUTING.md`](CONTRIBUTING.md). Locked constraints for any change:
+
+1. Filesystem stays the source of truth.
+2. SQLite schema unchanged.
+3. CLI stays stdlib-only.
+4. Web UI: stdlib backend, no build step, no new runtime deps, loopback bind.
+5. No new CLI commands or Store methods without maintainer approval — open an issue first.
+
+## Security
+
+See [`SECURITY.md`](SECURITY.md) for disclosure policy. Design notes: [`security_best_practices_report.md`](security_best_practices_report.md), [`skills-manager-threat-model.md`](skills-manager-threat-model.md).
+
+## Roadmap
+
+Where this is going: [`ROADMAP.md`](ROADMAP.md) (spec-lint+, cross-scope dedup, registry bridge, eval harness, VS Code extension…).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

skill_control_plane-1.0.1/README.md

@@ -0,0 +1,138 @@
+# skills-manager
+
+**The local control plane for your AI coding-agent skills.** Create, organize, sync, back up, and quality-check `SKILL.md` skills across every agent you use — from one CLI and one local web UI.
+
+[![CI](https://github.com/udayvarmora07/skills-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/udayvarmora07/skills-manager/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg)](pyproject.toml)
+
+> `skills-manager` on GitHub: `udayvarmora07/skills-manager`. PyPI badge tracks a future release: `skill-control-plane` is not on PyPI yet, so install from source or `pip install` the CI-built wheel/sdist below. Distribution name `skill-control-plane` (`skills-mgr` entry point) is reserved for that release.
+
+## Why this exists
+
+The [Agent Skills](https://agentskills.io) format (`SKILL.md`) is now an open standard supported by Claude Code, Cursor, Gemini CLI, OpenCode, Copilot/VS Code, Goose, Amp, and more. The ecosystem has **skill libraries** ([vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)), **installers** ([skills.sh](https://skills.sh)), and a **spec** — but nobody owns the *management* problem:
+
+- The same skill copy-pasted into `~/.claude/skills`, `~/.codex/skills`, Cursor dirs… edits diverge.
+- Vague descriptions cause false activation or misses; oversized bodies eat context.
+- No versioning, no safe update/rollback, no backup story, no cross-tool view.
+
+`skills-manager` fills that gap: one store, every scope, full lifecycle.
+
+| | skills-manager | `skills.sh` / `npx skills add` | skill libraries |
+|---|---|---|---|
+| Install remote skills | ✅ (via `install`) | ✅ | — (source) |
+| Create / edit / validate locally | ✅ | — | — |
+| Manage across **all** your agents | ✅ (`--scope all`) | single-target | — |
+| Sync + dedup between agents | ✅ | — | — |
+| Version history + trash/rollback | ✅ | — | — |
+| Token-footprint budgeting | ✅ (`tokens`) | — | — |
+| Local web UI | ✅ | — | — |
+
+## Install
+
+Requires Python ≥ 3.10. The runtime is **stdlib-only** — no dependencies.
+
+PyPI is not published yet (see `.github/workflows/release.yml` for the
+controlled Trusted Publishing path). Until the first GitHub Release lands:
+
+```bash
+pipx install skill-control-plane        # recommended (isolated)
+# or
+pip install skill-control-plane
+```
+
+Run without installing:
+
+```bash
+git clone https://github.com/udayvarmora07/skills-manager
+cd skills-manager
+python3 -m skillsmgr --help
+```
+
+## Quickstart
+
+```bash
+# 1. See everything you have, everywhere
+skills-mgr list --scope all
+
+# 2. Create a skill once…
+skills-mgr create my-workflow -d "Deploys our staging stack. Use when shipping to staging."
+
+# 3. …sync it to every agent you use
+skills-mgr sync my-workflow
+
+# 4. Or manage it visually (localhost only, no build step, works offline)
+skills-mgr webui
+```
+
+More:
+
+```bash
+skills-mgr search "deploy" --scope all   # scored search across agents
+skills-mgr tokens --scope all            # context-footprint budgeting
+skills-mgr validate --all                # spec lint incl. description/body guidance
+skills-mgr export                        # timestamped backup tarball
+skills-mgr install vercel-labs/agent-skills --dry-run   # preview remote install
+```
+
+## Agent scopes
+
+One command surface, per-agent directories underneath:
+
+| Scope | Directory |
+|---|---|
+| `global` (default) | manager store (`~/.local/share/skills-manager/skills/`) |
+| `claude-code` | `~/.claude/skills` |
+| `codex` | `~/.codex/skills` |
+| `cursor` | `~/.cursor/skills` |
+| `opencode` | `~/.config/opencode/skills` |
+| `gemini` | `~/.gemini/skills` |
+| `commandcode` | `~/.commandcode/skills` |
+| `agents` | `~/.agents/skills` |
+| `all` | merged read-only view |
+
+`list`, `view`, `search`, `doctor`, `stats` accept `--scope`; `sync` copies between scopes; `tokens`/`install` have their own scope semantics. Agent-scope writes go straight to the agent dir (no DB) — disable renames `SKILL.md` ⇄ `SKILL.md.disabled` in place, which Claude Code and Command Code both respect.
+
+## Web UI
+
+```bash
+skills-mgr webui              # http://127.0.0.1:8765, opens browser
+skills-mgr webui --no-browser # server only
+skills-mgr webui --port 9000  # custom port
+```
+
+Stdlib `ThreadingHTTPServer` backend + vendored Vue 3 (no npm, no CDN, works offline). Scope switcher, live search, trash with undo, validate/doctor/stats/history, templates, tar export plus tar/ZIP import, sync modal. Binds loopback only — never expose it; there is no auth (see [Threat model](skills-manager-threat-model.md)).
+
+## Data model
+
+- **Filesystem is the source of truth**: `<data>/skills/<name>/SKILL.md`.
+- **SQLite is a rebuildable index only** (`db rebuild` / `db resync` repair any drift; never hand-edit it).
+- Data dir: `$SKILLS_MANAGER_DATA` → `$XDG_DATA_HOME` → `~/.local/share`, then `/skills-manager`.
+
+## CLI reference
+
+37 invocable names: 27 top-level commands + 7 `trash`/`templates`/`db` subcommands + 3 `ls`/`rm`/`gui` aliases. Exit codes: `0` ok · `1` error · `2` usage · `130` interrupt. `--json` on data commands.
+
+Full surface: [`docs/03-cli-surface.md`](docs/03-cli-surface.md).
+
+## Contributing
+
+PRs welcome — start with [`CONTRIBUTING.md`](CONTRIBUTING.md). Locked constraints for any change:
+
+1. Filesystem stays the source of truth.
+2. SQLite schema unchanged.
+3. CLI stays stdlib-only.
+4. Web UI: stdlib backend, no build step, no new runtime deps, loopback bind.
+5. No new CLI commands or Store methods without maintainer approval — open an issue first.
+
+## Security
+
+See [`SECURITY.md`](SECURITY.md) for disclosure policy. Design notes: [`security_best_practices_report.md`](security_best_practices_report.md), [`skills-manager-threat-model.md`](skills-manager-threat-model.md).
+
+## Roadmap
+
+Where this is going: [`ROADMAP.md`](ROADMAP.md) (spec-lint+, cross-scope dedup, registry bridge, eval harness, VS Code extension…).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

skill_control_plane-1.0.1/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "skill-control-plane"
+version = "1.0.1"
+description = "Local control plane for AI coding-agent skills: manage SKILL.md across agents from one CLI + web UI"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "skills-manager contributors" }]
+keywords = ["ai-agents", "agent-skills", "skill-management", "cli", "claude-code", "cursor", "opencode"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/udayvarmora07/skills-manager"
+Repository = "https://github.com/udayvarmora07/skills-manager"
+Issues = "https://github.com/udayvarmora07/skills-manager/issues"
+Documentation = "https://github.com/udayvarmora07/skills-manager#readme"
+Changelog = "https://github.com/udayvarmora07/skills-manager/blob/main/CHANGELOG.md"
+
+[project.scripts]
+skills-mgr = "skillsmgr.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["skillsmgr*"]
+
+[tool.setuptools.package-data]
+skillsmgr = ["webui/*", "webui/static/vendor/*"]

skill_control_plane-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

skill_control_plane-1.0.1/skill_control_plane.egg-info/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: skill-control-plane
+Version: 1.0.1
+Summary: Local control plane for AI coding-agent skills: manage SKILL.md across agents from one CLI + web UI
+Author: skills-manager contributors
+License: MIT
+Project-URL: Homepage, https://github.com/udayvarmora07/skills-manager
+Project-URL: Repository, https://github.com/udayvarmora07/skills-manager
+Project-URL: Issues, https://github.com/udayvarmora07/skills-manager/issues
+Project-URL: Documentation, https://github.com/udayvarmora07/skills-manager#readme
+Project-URL: Changelog, https://github.com/udayvarmora07/skills-manager/blob/main/CHANGELOG.md
+Keywords: ai-agents,agent-skills,skill-management,cli,claude-code,cursor,opencode
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# skills-manager
+
+**The local control plane for your AI coding-agent skills.** Create, organize, sync, back up, and quality-check `SKILL.md` skills across every agent you use — from one CLI and one local web UI.
+
+[![CI](https://github.com/udayvarmora07/skills-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/udayvarmora07/skills-manager/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg)](pyproject.toml)
+
+> `skills-manager` on GitHub: `udayvarmora07/skills-manager`. PyPI badge tracks a future release: `skill-control-plane` is not on PyPI yet, so install from source or `pip install` the CI-built wheel/sdist below. Distribution name `skill-control-plane` (`skills-mgr` entry point) is reserved for that release.
+
+## Why this exists
+
+The [Agent Skills](https://agentskills.io) format (`SKILL.md`) is now an open standard supported by Claude Code, Cursor, Gemini CLI, OpenCode, Copilot/VS Code, Goose, Amp, and more. The ecosystem has **skill libraries** ([vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)), **installers** ([skills.sh](https://skills.sh)), and a **spec** — but nobody owns the *management* problem:
+
+- The same skill copy-pasted into `~/.claude/skills`, `~/.codex/skills`, Cursor dirs… edits diverge.
+- Vague descriptions cause false activation or misses; oversized bodies eat context.
+- No versioning, no safe update/rollback, no backup story, no cross-tool view.
+
+`skills-manager` fills that gap: one store, every scope, full lifecycle.
+
+| | skills-manager | `skills.sh` / `npx skills add` | skill libraries |
+|---|---|---|---|
+| Install remote skills | ✅ (via `install`) | ✅ | — (source) |
+| Create / edit / validate locally | ✅ | — | — |
+| Manage across **all** your agents | ✅ (`--scope all`) | single-target | — |
+| Sync + dedup between agents | ✅ | — | — |
+| Version history + trash/rollback | ✅ | — | — |
+| Token-footprint budgeting | ✅ (`tokens`) | — | — |
+| Local web UI | ✅ | — | — |
+
+## Install
+
+Requires Python ≥ 3.10. The runtime is **stdlib-only** — no dependencies.
+
+PyPI is not published yet (see `.github/workflows/release.yml` for the
+controlled Trusted Publishing path). Until the first GitHub Release lands:
+
+```bash
+pipx install skill-control-plane        # recommended (isolated)
+# or
+pip install skill-control-plane
+```
+
+Run without installing:
+
+```bash
+git clone https://github.com/udayvarmora07/skills-manager
+cd skills-manager
+python3 -m skillsmgr --help
+```
+
+## Quickstart
+
+```bash
+# 1. See everything you have, everywhere
+skills-mgr list --scope all
+
+# 2. Create a skill once…
+skills-mgr create my-workflow -d "Deploys our staging stack. Use when shipping to staging."
+
+# 3. …sync it to every agent you use
+skills-mgr sync my-workflow
+
+# 4. Or manage it visually (localhost only, no build step, works offline)
+skills-mgr webui
+```
+
+More:
+
+```bash
+skills-mgr search "deploy" --scope all   # scored search across agents
+skills-mgr tokens --scope all            # context-footprint budgeting
+skills-mgr validate --all                # spec lint incl. description/body guidance
+skills-mgr export                        # timestamped backup tarball
+skills-mgr install vercel-labs/agent-skills --dry-run   # preview remote install
+```
+
+## Agent scopes
+
+One command surface, per-agent directories underneath:
+
+| Scope | Directory |
+|---|---|
+| `global` (default) | manager store (`~/.local/share/skills-manager/skills/`) |
+| `claude-code` | `~/.claude/skills` |
+| `codex` | `~/.codex/skills` |
+| `cursor` | `~/.cursor/skills` |
+| `opencode` | `~/.config/opencode/skills` |
+| `gemini` | `~/.gemini/skills` |
+| `commandcode` | `~/.commandcode/skills` |
+| `agents` | `~/.agents/skills` |
+| `all` | merged read-only view |
+
+`list`, `view`, `search`, `doctor`, `stats` accept `--scope`; `sync` copies between scopes; `tokens`/`install` have their own scope semantics. Agent-scope writes go straight to the agent dir (no DB) — disable renames `SKILL.md` ⇄ `SKILL.md.disabled` in place, which Claude Code and Command Code both respect.
+
+## Web UI
+
+```bash
+skills-mgr webui              # http://127.0.0.1:8765, opens browser
+skills-mgr webui --no-browser # server only
+skills-mgr webui --port 9000  # custom port
+```
+
+Stdlib `ThreadingHTTPServer` backend + vendored Vue 3 (no npm, no CDN, works offline). Scope switcher, live search, trash with undo, validate/doctor/stats/history, templates, tar export plus tar/ZIP import, sync modal. Binds loopback only — never expose it; there is no auth (see [Threat model](skills-manager-threat-model.md)).
+
+## Data model
+
+- **Filesystem is the source of truth**: `<data>/skills/<name>/SKILL.md`.
+- **SQLite is a rebuildable index only** (`db rebuild` / `db resync` repair any drift; never hand-edit it).
+- Data dir: `$SKILLS_MANAGER_DATA` → `$XDG_DATA_HOME` → `~/.local/share`, then `/skills-manager`.
+
+## CLI reference
+
+37 invocable names: 27 top-level commands + 7 `trash`/`templates`/`db` subcommands + 3 `ls`/`rm`/`gui` aliases. Exit codes: `0` ok · `1` error · `2` usage · `130` interrupt. `--json` on data commands.
+
+Full surface: [`docs/03-cli-surface.md`](docs/03-cli-surface.md).
+
+## Contributing
+
+PRs welcome — start with [`CONTRIBUTING.md`](CONTRIBUTING.md). Locked constraints for any change:
+
+1. Filesystem stays the source of truth.
+2. SQLite schema unchanged.
+3. CLI stays stdlib-only.
+4. Web UI: stdlib backend, no build step, no new runtime deps, loopback bind.
+5. No new CLI commands or Store methods without maintainer approval — open an issue first.
+
+## Security
+
+See [`SECURITY.md`](SECURITY.md) for disclosure policy. Design notes: [`security_best_practices_report.md`](security_best_practices_report.md), [`skills-manager-threat-model.md`](skills-manager-threat-model.md).
+
+## Roadmap
+
+Where this is going: [`ROADMAP.md`](ROADMAP.md) (spec-lint+, cross-scope dedup, registry bridge, eval harness, VS Code extension…).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

skill_control_plane-1.0.1/skill_control_plane.egg-info/SOURCES.txt

@@ -0,0 +1,58 @@
+LICENSE
+README.md
+pyproject.toml
+skill_control_plane.egg-info/PKG-INFO
+skill_control_plane.egg-info/SOURCES.txt
+skill_control_plane.egg-info/dependency_links.txt
+skill_control_plane.egg-info/entry_points.txt
+skill_control_plane.egg-info/top_level.txt
+skillsmgr/__init__.py
+skillsmgr/__main__.py
+skillsmgr/archive.py
+skillsmgr/atomic_io.py
+skillsmgr/cli.py
+skillsmgr/cli_handlers.py
+skillsmgr/cli_output.py
+skillsmgr/cli_parser.py
+skillsmgr/colors.py
+skillsmgr/diagnostics.py
+skillsmgr/frontmatter.py
+skillsmgr/insights.py
+skillsmgr/loader.py
+skillsmgr/observations.py
+skillsmgr/path_safety.py
+skillsmgr/paths.py
+skillsmgr/root_discovery.py
+skillsmgr/scopes.py
+skillsmgr/search.py
+skillsmgr/store.py
+skillsmgr/templates.py
+skillsmgr/tokens.py
+skillsmgr/validator.py
+skillsmgr/web_security.py
+skillsmgr/web_serialization.py
+skillsmgr/web_upload.py
+skillsmgr/webapp.py
+skillsmgr/webui/app.js
+skillsmgr/webui/domain.js
+skillsmgr/webui/index.html
+skillsmgr/webui/styles.css
+skillsmgr/webui/static/vendor/vue.global.prod.js
+tests/test_archive_contracts.py
+tests/test_ci_release_contracts.py
+tests/test_cli_contract.py
+tests/test_compatibility.py
+tests/test_complexity_budget.py
+tests/test_concurrency_contracts.py
+tests/test_docs_consistency.py
+tests/test_frontmatter_contracts.py
+tests/test_insights_contracts.py
+tests/test_package_data.py
+tests/test_path_safety.py
+tests/test_scope_contracts.py
+tests/test_search_contracts.py
+tests/test_smoke_fixtures.py
+tests/test_store.py
+tests/test_store_contracts.py
+tests/test_web_scopes.py
+tests/test_webapp.py

skill_control_plane-1.0.1/skill_control_plane.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

skill_control_plane-1.0.1/skill_control_plane.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+skills-mgr = skillsmgr.cli:main

skill_control_plane-1.0.1/skill_control_plane.egg-info/top_level.txt

@@ -0,0 +1 @@
+skillsmgr

skill_control_plane-1.0.1/skillsmgr/__init__.py

@@ -0,0 +1,3 @@
+"""skills-mgr: manage agentic AI skills (SKILL.md) from the command line."""
+
+__version__ = "1.0.1"

skill_control_plane-1.0.1/skillsmgr/__main__.py

@@ -0,0 +1,10 @@
+"""Entry point for ``python3 -m skillsmgr``."""
+
+from __future__ import annotations
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())