skill-control-plane 1.0.1__py3-none-any.whl

skill_control_plane-1.0.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,38 @@
+skill_control_plane-1.0.1.dist-info/licenses/LICENSE,sha256=eXUBKuw1JnIUB5ZU6PdSzd8D9XUQmA4X9pWQm604U0g,1084
+skillsmgr/__init__.py,sha256=ZvvBeJo-6L-mDMGGaZMIlijoTw7fNdzTQImP3Lipk_c,100
+skillsmgr/__main__.py,sha256=-wWUQk_nbZXKeOmFFvssfYNBkSmqM_N2iu0oqqQk9jk,168
+skillsmgr/archive.py,sha256=SkjI-QNA0xhp-TH1ySrR8RTlDVxIIcg3mralTI7hlWg,19417
+skillsmgr/atomic_io.py,sha256=AfZzRvgnxEeoGaOchMxVIFgDcyaiSKNXf6NTPIb4Q18,2642
+skillsmgr/cli.py,sha256=GYkzitNsembqWm8ofNCs-8Mq9pc1ZtbkXEaUf22Wu8I,3929
+skillsmgr/cli_handlers.py,sha256=m0P7FyIR5aoTIaWuQZ2EEcgS4bw0QSqRruPkN8SV8kk,33663
+skillsmgr/cli_output.py,sha256=tU4_h2nISF2-M3--xTuAwsFzuqaKf5jP0RqqnZXmkdw,1537
+skillsmgr/cli_parser.py,sha256=7_e29NxeFH3G1T33nHnbeXWvq7IadD0kYigIzyOTjn4,13172
+skillsmgr/colors.py,sha256=pSMMo874W2_x2VS9NCpt65P8VdeVdiCvE0HmYKRCprU,1495
+skillsmgr/diagnostics.py,sha256=qz8b9Nx8x0QuXIjlu7sCaETkjFu3m_lBsekHleL_wIA,575
+skillsmgr/frontmatter.py,sha256=dBvC26SBW9dBiMQIwK79VAI4bmoJvYyyVYJ3Lms_Lik,34523
+skillsmgr/insights.py,sha256=-uudJ5pl4wHfIi9IUr3daZ1dKMBVyX5MwaSd_zl8NYE,19015
+skillsmgr/loader.py,sha256=I3djBPQMWwPK0j2jYYszNkUdH_lFasUyyNhe_qll2YU,3452
+skillsmgr/observations.py,sha256=5pl0Dtq9Un40hEiCeECjJx4GIGurPYNdIBSe4GvvKhQ,1490
+skillsmgr/path_safety.py,sha256=RxrYs_poh3zkQ5iRf6lwZCmxYFM8Ai1xzFW_gOFxWuw,1990
+skillsmgr/paths.py,sha256=DivY5vWagNDumH6UpP2PQIvj7XHPoGSpVLIJY5QVqaA,2121
+skillsmgr/root_discovery.py,sha256=qpt9-9nmz-f47A2MOQdVVqLGY3UyKM65Usvp4enAyCY,2566
+skillsmgr/scopes.py,sha256=A5PthMnrnTd79SY6BcvJsGH-5fThKHBioQIn0iSOaZY,29377
+skillsmgr/search.py,sha256=t10ITGjx7tz93UKvxzbac771PXZ4YgzG322hHBA2Lp4,2679
+skillsmgr/store.py,sha256=l3FV-jjPcho3d0TEpJ1Or_vsshdCSz92AWjwpViLdR0,62217
+skillsmgr/templates.py,sha256=HMCCutZzf8YIPsJmkaoZlh7VMeOr9qcVkDP_HL8AGtQ,2176
+skillsmgr/tokens.py,sha256=rmdA6SwWqOvidi2ELSUSNx9LarK2JYF_ZsWRXUjmDcs,3938
+skillsmgr/validator.py,sha256=I2QQcbpy6HNFI74J27uHFVo0K7CDaKmGSpTJhfOAjt0,13128
+skillsmgr/web_security.py,sha256=M_CeFl2f_PIhEl1PUG-JoaH2105kYuB6lLPGNO0FYCg,1963
+skillsmgr/web_serialization.py,sha256=Y1oVaeuYhi5kdRTdVOa7w7NoiB8FftCLmEuT6-nZKGc,1079
+skillsmgr/web_upload.py,sha256=CX-TBXfGjOXlT1PTxLN-ovI_Q7vjjcZdUmmXKAly1QM,3813
+skillsmgr/webapp.py,sha256=ea1SYXZZ7tWkX6zwq9uBw0bFcF4UnyYZKdRZ6y58b5s,38350
+skillsmgr/webui/app.js,sha256=maXnkkN83jT7ioJ62K9PQoCZJmtzJyN0Qf0zLA8Z2Yo,35888
+skillsmgr/webui/domain.js,sha256=4cbsiLPpXKI_JZnPfXYvIP8W2ipRIPaV3IttsEOeL4g,5537
+skillsmgr/webui/index.html,sha256=OPSnySxah_UYD1glIlE5PtXcTqm5h-yGj2wYgJS6gQ0,55840
+skillsmgr/webui/styles.css,sha256=kxtMuMCK2DeWtPXOh10S2KwBVOo3xgVUwINE01G_TJk,25302
+skillsmgr/webui/static/vendor/vue.global.prod.js,sha256=xFm6fMjbZcmCWJ-l1kx_9HiHfo5bD9dWgyB87GpOieg,157924
+skill_control_plane-1.0.1.dist-info/METADATA,sha256=f5Y8QjVzcbi567uV93MIutCxz1WEtR0UcHjQOCeVHrQ,7529
+skill_control_plane-1.0.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+skill_control_plane-1.0.1.dist-info/entry_points.txt,sha256=EiOfHf1_W2moDgJv0HCw8rbWIrO8xA_caGjuEZFSIss,50
+skill_control_plane-1.0.1.dist-info/top_level.txt,sha256=DYf4q_v-ju1sKh8z-3GZMjpRJD3TnDRs6TljjgMeD_c,10
+skill_control_plane-1.0.1.dist-info/RECORD,,

skill_control_plane-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

skill_control_plane-1.0.1.dist-info/entry_points.txt

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

skill_control_plane-1.0.1.dist-info/licenses/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.dist-info/top_level.txt

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

skillsmgr/__init__.py

@@ -0,0 +1,3 @@
+"""skills-mgr: manage agentic AI skills (SKILL.md) from the command line."""
+
+__version__ = "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())