skyboy 0.1.0__tar.gz

skyboy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skyboy project 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.

skyboy-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: skyboy
+Version: 0.1.0
+Summary: The skyboy CLI: add portable SKILL.md skills to your project with one command.
+License-Expression: MIT
+Project-URL: Homepage, https://skyboy.in
+Project-URL: Source, https://github.com/aijadugar/skyboy
+Keywords: skills,claude,cursor,gemini,mcp,skboy,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# skyboy (PyPI)
+
+The native Python CLI for the skyboy.in skill directory. This is the Python
+counterpart to the npm `skyboy` package. It intentionally avoids pulling in Node
+at any point, so it reaches the Python-only audience (data science, Kaggle, ML
+eval, etc.).
+
+## Install
+
+```bash
+pip install skyboy
+# or
+pipx install skyboy
+```
+
+## Usage
+
+```bash
+skyboy add <slug> [--dir <path>]
+skyboy search <query>
+skyboy list
+skyboy resolve <slug>
+skyboy version
+skyboy help
+```
+
+Example:
+
+```bash
+# Add a skill to the Claude Code skills folder.
+skyboy add nextjs-app-router-conventions
+
+# Add a skill to a custom folder.
+skyboy add context-window-management --dir .cursor/rules
+
+# Search the catalog.
+skyboy search "app router"
+
+# List everything available.
+skyboy list
+```
+
+## Parity with the npm CLI
+
+This release ships real packaging plus the `add` command, which resolves a slug
+from the shared `catalog.json` manifest (committed to the skyboy repo, fetched
+from raw.githubusercontent.com) and downloads the skill folder files. It also
+covers `search`, `list`, `resolve`, and `version`.
+
+The following are documented follow-ups on the npm package, not yet in this
+PyPI release:
+
+- Agent-context detection (auto-detecting Claude Code vs. Cursor vs. Windsurf
+  from the current directory).
+- The interactive target-folder picker.
+
+To choose a target folder directly, pass `--dir` (default `.claude/skills`).
+
+## Why a separate manifest?
+
+The CLI runs in arbitrary user projects with no local copy of the skyboy repo.
+To stay standalilone, it sources catalog data from a single shareable manifest:
+
+`https://raw.githubusercontent.com/aijadugar/skyboy/main/catalog.json`
+
+If a local `catalog.json` exists in the current directory, it is used instead
+(useful for offline development and for the repo itself).
+
+## License
+
+MIT

skyboy-0.1.0/README.md

@@ -0,0 +1,71 @@
+# skyboy (PyPI)
+
+The native Python CLI for the skyboy.in skill directory. This is the Python
+counterpart to the npm `skyboy` package. It intentionally avoids pulling in Node
+at any point, so it reaches the Python-only audience (data science, Kaggle, ML
+eval, etc.).
+
+## Install
+
+```bash
+pip install skyboy
+# or
+pipx install skyboy
+```
+
+## Usage
+
+```bash
+skyboy add <slug> [--dir <path>]
+skyboy search <query>
+skyboy list
+skyboy resolve <slug>
+skyboy version
+skyboy help
+```
+
+Example:
+
+```bash
+# Add a skill to the Claude Code skills folder.
+skyboy add nextjs-app-router-conventions
+
+# Add a skill to a custom folder.
+skyboy add context-window-management --dir .cursor/rules
+
+# Search the catalog.
+skyboy search "app router"
+
+# List everything available.
+skyboy list
+```
+
+## Parity with the npm CLI
+
+This release ships real packaging plus the `add` command, which resolves a slug
+from the shared `catalog.json` manifest (committed to the skyboy repo, fetched
+from raw.githubusercontent.com) and downloads the skill folder files. It also
+covers `search`, `list`, `resolve`, and `version`.
+
+The following are documented follow-ups on the npm package, not yet in this
+PyPI release:
+
+- Agent-context detection (auto-detecting Claude Code vs. Cursor vs. Windsurf
+  from the current directory).
+- The interactive target-folder picker.
+
+To choose a target folder directly, pass `--dir` (default `.claude/skills`).
+
+## Why a separate manifest?
+
+The CLI runs in arbitrary user projects with no local copy of the skyboy repo.
+To stay standalilone, it sources catalog data from a single shareable manifest:
+
+`https://raw.githubusercontent.com/aijadugar/skyboy/main/catalog.json`
+
+If a local `catalog.json` exists in the current directory, it is used instead
+(useful for offline development and for the repo itself).
+
+## License
+
+MIT

skyboy-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "skyboy"
+version = "0.1.0"
+description = "The skyboy CLI: add portable SKILL.md skills to your project with one command."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["skills", "claude", "cursor", "gemini", "mcp", "skboy", "cli"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Libraries",
+]
+
+[project.urls]
+Homepage = "https://skyboy.in"
+Source = "https://github.com/aijadugar/skyboy"
+
+[project.scripts]
+skyboy = "skyboy.__main__:main"
+
+[tool.setuptools]
+packages = ["skyboy"]

skyboy-0.1.0/setup.cfg

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

skyboy-0.1.0/skyboy/__init__.py

@@ -0,0 +1,3 @@
+"""skyboy - the PyPI CLI for the skyboy.in skill directory."""
+
+__version__ = "0.1.0"

skyboy-0.1.0/skyboy/__main__.py

@@ -0,0 +1,195 @@
+"""stdlib-only `skyboy` CLI for the skyboy.in skill directory (PyPI).
+
+Publishing notes (see README): this is the native Python implementation of the
+CLI. It intentionally avoids pulling in Node at any point, so it targets the
+Python-only audience (data science, Kaggle, ML eval, etc.) that §8 method C
+wants to reach. It shares the same install-manifest format (catalog.json) as the
+npm CLI.
+
+v2: catalog records are compact (id, d, c, t, a, v, h, o, y, p per
+docs/skill-spec.md §6). Ids may be bare slugs (skyboy skills) or scoped
+@owner/slug (vendor and community skills); the install folder is always the
+slug part.
+
+Scope for this release: `add`, `search`, `list`, `resolve`, `version`.
+Agent-context detection and the interactive target-folder prompt are documented
+follow-ups on the npm package; here we accept an explicit `--dir` or default to
+`.claude/skills`. This keeps the dual-publish story honest.
+"""
+
+import json
+import sys
+import urllib.request
+from pathlib import Path
+
+from . import __version__
+
+MANIFEST_URL = "https://raw.githubusercontent.com/aijadugar/skyboy/main/catalog.json"
+DEFAULT_TARGET_DIR = ".claude/skills"
+RAW_BASE = "https://raw.githubusercontent.com/aijadugar/skyboy/main"
+
+
+def _fetch_json(url):
+    with urllib.request.urlopen(url, timeout=30) as resp:
+        return json.loads(resp.read().decode("utf-8"))
+
+
+def _resolve_manifest(cwd):
+    local = Path(cwd) / "catalog.json"
+    if local.exists():
+        return json.loads(local.read_text("utf-8"))
+    return _fetch_json(MANIFEST_URL)
+
+
+def _slug(record):
+    """The slug part of an id: 'x' for bare, 'slug' for @owner/slug."""
+    rid = record.get("id", "")
+    return rid.split("/", 1)[1] if rid.startswith("@") else rid
+
+
+def _skill_folder(record):
+    if record.get("p"):
+        return record["p"]
+    return "skills/{}/{}".format(record.get("c", "uncategorized").split("/")[0], _slug(record))
+
+
+def _add(args):
+    if not args:
+        print("skyboy: add requires a <slug>. Run 'skyboy help' for usage.")
+        return 1
+    skill_id = args[0]
+    target_dir = DEFAULT_TARGET_DIR
+    if "--dir" in args:
+        idx = args.index("--dir")
+        if idx + 1 < len(args):
+            target_dir = args[idx + 1]
+
+    catalog = _resolve_manifest(Path.cwd())
+    skills = catalog.get("skills", [])
+    match = next((s for s in skills if s.get("id") == skill_id or _slug(s) == skill_id), None)
+    if not match:
+        print("skyboy: could not resolve '{}' to a skill. Try 'skyboy search {}'.".format(skill_id, skill_id))
+        return 1
+
+    folder = _skill_folder(match)
+    dest = Path(target_dir) / _slug(match)
+    dest.mkdir(parents=True, exist_ok=True)
+
+    # Enumerate the folder with the GitHub contents API (recursive).
+    api = "https://api.github.com/repos/aijadugar/skyboy/contents/{}".format(folder)
+    stack = [folder]
+    entries = []
+    while stack:
+        d = stack.pop()
+        url = api if d == folder else d
+        payload = _fetch_json(url)
+        for child in payload:
+            if child["type"] == "dir":
+                stack.append(child["path"])
+            else:
+                entries.append(child)
+
+    written = 0
+    for entry in entries:
+        rel = entry["path"][len(folder) + 1 :]
+        local = dest / Path(rel)
+        local.parent.mkdir(parents=True, exist_ok=True)
+        local.write_bytes(_download(entry))
+        written += 1
+
+    print("skyboy: added '{}' to {}/{}.".format(match.get("id"), target_dir, _slug(match)))
+    print("  version: v{}  |  origin: {}  |  category: {}".format(
+        match.get("v", "1.0.0"), match.get("o", "community"), match.get("c", "uncategorized")))
+    print("  {} file(s) written.".format(written))
+    print("  next steps: https://skyboy.in/agents/mcp")
+
+
+def _download(entry):
+    url = entry["download_url"]
+    with urllib.request.urlopen(url, timeout=30) as resp:
+        return resp.read()
+
+
+def _search(args):
+    if not args:
+        print("skyboy: search requires a <query>.")
+        return 1
+    query = args[0].lower()
+    catalog = _resolve_manifest(Path.cwd())
+    terms = [t for t in query.split() if t]
+    for s in catalog.get("skills", []):
+        hay = " ".join([s.get("id", ""), s.get("d", ""), " ".join(s.get("t", []))]).lower()
+        if all(t in hay for t in terms):
+            print("{}\t{}\t({})".format(s.get("id"), s.get("d", ""), s.get("c", "uncategorized")))
+
+
+def _list(_args):
+    catalog = _resolve_manifest(Path.cwd())
+    for s in sorted(catalog.get("skills", []), key=lambda x: x.get("id", "").lower()):
+        print("{}\t{}\t({})\tv{}".format(
+            s.get("id"), s.get("d", ""), s.get("c", "uncategorized"), s.get("v", "1.0.0")))
+
+
+def _resolve(args):
+    if not args:
+        print("skyboy: resolve requires a <slug>.")
+        return 1
+    skill_id = args[0]
+    catalog = _resolve_manifest(Path.cwd())
+    match = next((s for s in catalog.get("skills", []) if s.get("id") == skill_id or _slug(s) == skill_id), None)
+    if not match:
+        print("skyboy: could not resolve '{}'.".format(skill_id))
+        return 1
+    folder = _skill_folder(match)
+    print("id:", match.get("id"))
+    print("path:", folder)
+    print("description:", match.get("d", ""))
+    print("version: v{}".format(match.get("v", "1.0.0")))
+    print("hash:", match.get("h", ""))
+    print("raw: {}/{}".format(RAW_BASE, folder) + "/SKILL.md")
+
+
+def _version(_args):
+    catalog = _resolve_manifest(Path.cwd())
+    print("skyboy {} (catalog v{}).".format(__version__, catalog.get("version", 1)))
+
+
+def _help(_args):
+    print("""skyboy - add portable SKILL.md skills to your project.
+
+Usage:
+  skyboy add <slug|@owner/slug> [--dir <path>]
+  skyboy search <query>
+  skyboy list
+  skyboy resolve <slug|@owner/slug>
+  skyboy version
+  skyboy help
+
+Note: this PyPI CLI covers resolve + download. Agent-context detection and the
+interactive target-folder prompt are a follow-up on the npm package; pass
+--dir to choose a target folder directly.""")
+
+
+def main(argv=None):
+    args = sys.argv[1:] if argv is None else argv
+    if not args:
+        return _help(args)
+    cmd, rest = args[0], args[1:]
+    handler = {
+        "add": _add,
+        "search": _search,
+        "list": _list,
+        "resolve": _resolve,
+        "version": _version,
+        "help": _help,
+        "--help": _help,
+        "-h": _help,
+    }.get(cmd)
+    if handler is None:
+        print("skyboy: unknown command '{}'. Run 'skyboy help'.".format(cmd))
+        return 1
+    return handler(rest)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

skyboy-0.1.0/skyboy.egg-info/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: skyboy
+Version: 0.1.0
+Summary: The skyboy CLI: add portable SKILL.md skills to your project with one command.
+License-Expression: MIT
+Project-URL: Homepage, https://skyboy.in
+Project-URL: Source, https://github.com/aijadugar/skyboy
+Keywords: skills,claude,cursor,gemini,mcp,skboy,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# skyboy (PyPI)
+
+The native Python CLI for the skyboy.in skill directory. This is the Python
+counterpart to the npm `skyboy` package. It intentionally avoids pulling in Node
+at any point, so it reaches the Python-only audience (data science, Kaggle, ML
+eval, etc.).
+
+## Install
+
+```bash
+pip install skyboy
+# or
+pipx install skyboy
+```
+
+## Usage
+
+```bash
+skyboy add <slug> [--dir <path>]
+skyboy search <query>
+skyboy list
+skyboy resolve <slug>
+skyboy version
+skyboy help
+```
+
+Example:
+
+```bash
+# Add a skill to the Claude Code skills folder.
+skyboy add nextjs-app-router-conventions
+
+# Add a skill to a custom folder.
+skyboy add context-window-management --dir .cursor/rules
+
+# Search the catalog.
+skyboy search "app router"
+
+# List everything available.
+skyboy list
+```
+
+## Parity with the npm CLI
+
+This release ships real packaging plus the `add` command, which resolves a slug
+from the shared `catalog.json` manifest (committed to the skyboy repo, fetched
+from raw.githubusercontent.com) and downloads the skill folder files. It also
+covers `search`, `list`, `resolve`, and `version`.
+
+The following are documented follow-ups on the npm package, not yet in this
+PyPI release:
+
+- Agent-context detection (auto-detecting Claude Code vs. Cursor vs. Windsurf
+  from the current directory).
+- The interactive target-folder picker.
+
+To choose a target folder directly, pass `--dir` (default `.claude/skills`).
+
+## Why a separate manifest?
+
+The CLI runs in arbitrary user projects with no local copy of the skyboy repo.
+To stay standalilone, it sources catalog data from a single shareable manifest:
+
+`https://raw.githubusercontent.com/aijadugar/skyboy/main/catalog.json`
+
+If a local `catalog.json` exists in the current directory, it is used instead
+(useful for offline development and for the repo itself).
+
+## License
+
+MIT

skyboy-0.1.0/skyboy.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+skyboy/__init__.py
+skyboy/__main__.py
+skyboy.egg-info/PKG-INFO
+skyboy.egg-info/SOURCES.txt
+skyboy.egg-info/dependency_links.txt
+skyboy.egg-info/entry_points.txt
+skyboy.egg-info/top_level.txt

skyboy-0.1.0/skyboy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

skyboy-0.1.0/skyboy.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+skyboy = skyboy.__main__:main

skyboy-0.1.0/skyboy.egg-info/top_level.txt

@@ -0,0 +1 @@
+skyboy