skilly 0.0.2a0__tar.gz

skilly-0.0.2a0/.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: Build and test python application
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+concurrency:
+  group: ${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - uses: extractions/setup-just@v3
+    - uses: astral-sh/setup-uv@v7
+      with:
+        cache-dependency-glob: "**/pyproject.toml"
+    - run: uv python install 3.10
+    - run: just install
+    - run: just lint
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+    steps:
+      - uses: actions/checkout@v6
+      - uses: extractions/setup-just@v3
+      - uses: astral-sh/setup-uv@v7
+        with:
+          cache-dependency-glob: "**/pyproject.toml"
+      - run: uv python install ${{ matrix.python-version }}
+      - run: just install
+      - run: just test . --cov=. --cov-report xml -rs

skilly-0.0.2a0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish Package
+
+on:
+    release:
+        types:
+        - published
+
+jobs:
+  publish:
+    environment: publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: extractions/setup-just@v3
+      - uses: astral-sh/setup-uv@v7
+        with:
+          cache-dependency-glob: "**/pyproject.toml"
+      - run: just publish
+        env:
+          PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}

skilly-0.0.2a0/.gitignore

@@ -0,0 +1,27 @@
+# Generated by Cargo
+# will have compiled files and executables
+debug
+target
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# Generated by cargo mutants
+# Contains mutation testing data
+**/mutants.out*/
+
+# RustRover
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+
+# Added by cargo
+
+/target
+.venv

skilly-0.0.2a0/.python-version

@@ -0,0 +1 @@
+3.13

skilly-0.0.2a0/LICENSE

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

skilly-0.0.2a0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: skilly
+Version: 0.0.2a0
+Summary: Add your description here
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: cyclopts>=4
+Requires-Dist: niquests>=3
+Description-Content-Type: text/markdown
+
+# skilly
+
+Read agent skills from dependencies.

skilly-0.0.2a0/README.md

@@ -0,0 +1,3 @@
+# skilly
+
+Read agent skills from dependencies.

skilly-0.0.2a0/justfile

@@ -0,0 +1,43 @@
+[private]
+default:
+    @just --list
+
+# update dependencies
+update:
+    uv lock --upgrade
+    @just install
+
+# upgrade dependencies
+upgrade:
+    @just update
+
+# install dependencies
+install:
+    uv sync --all-extras --frozen
+    @just hook
+
+# lint project
+lint:
+    uv run prek run --all-files
+
+# test project
+test *args:
+    uv run --no-sync pytest {{ args }}
+
+# type check project
+typecheck:
+    uv run pyrefly check
+
+# install pre-commit hooks
+hook:
+    uv run prek install --install-hooks --overwrite
+
+# uninstall pre-commit hooks
+unhook:
+    uv run prek uninstall
+
+# publish project on pypi
+publish:
+    rm -rf dist
+    uv build
+    uv publish --token $PYPI_TOKEN

skilly-0.0.2a0/prek.toml

@@ -0,0 +1,47 @@
+# Configuration file for `prek`, a git hook framework written in Rust.
+# See https://prek.j178.dev for more information.
+#:schema https://www.schemastore.org/prek.json
+
+[[repos]]
+repo = "https://github.com/astral-sh/ruff-pre-commit"
+rev = "v0.15.8"
+hooks = [
+  {
+    id = "ruff",
+    name = "ruff",
+    files = "^src|^tests",
+    args = ["--fix"]
+  },
+  {
+    id = "ruff-format",
+    files = "^src|^tests|^examples|^docs"
+  }
+]
+
+[[repos]]
+repo = "https://github.com/pre-commit/pre-commit-hooks"
+rev = "v6.0.0"
+hooks = [
+  { id = "end-of-file-fixer"},
+  { id = "mixed-line-ending"}
+]
+
+
+[[repos]]
+repo = "local"
+hooks = [
+    {
+    id = "just-format",
+    name = "just format",
+    entry = "just --unstable --fmt",
+    language = "system",
+    pass_filenames = false
+    },
+    {
+    id = "type",
+    name ="type",
+    entry = "just typecheck",
+    language = "system",
+    pass_filenames = false
+    },
+]

skilly-0.0.2a0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = [
+    "hatchling", "hatch-vcs"
+]
+build-backend = "hatchling.build"
+
+
+[project]
+name = "skilly"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "cyclopts>=4",
+    "niquests>=3",
+]
+dynamic = ["version"]
+
+[project.scripts]
+skilly = "skilly.cli.root:cli"
+
+[dependency-groups]
+dev = [
+    "prek>=0.3.13",
+    "pyrefly>=0.64.0",
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.3.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.15.12",
+]
+
+
+[tool.pytest.ini_options]
+addopts = [
+    "--import-mode=importlib",
+    "--ignore=.tox/",
+    "--ignore=tmp/"
+]
+pythonpath=["src", "tests"]
+
+
+[tool.hatch.version]
+source = "vcs"
+fallback-version = "0.0.1"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/skilly"]

skilly-0.0.2a0/src/skilly/__init__.py

@@ -0,0 +1,7 @@
+from skilly.util import get_project_skills
+from skilly.skills import Skill
+
+__all__ = [
+    "Skill",
+    "get_project_skills",
+]

skilly-0.0.2a0/src/skilly/cli/root.py

@@ -0,0 +1,22 @@
+from pathlib import Path
+
+from cyclopts import App
+from skilly.cli.util import util_cli
+
+
+cli = App()
+
+cli.command(util_cli)
+
+
+@cli.command()
+def list() -> None:
+    from skilly.parsers import parse_toml
+    from skilly.parsers import PyProjectInfo
+    from skilly.skills import VenvSkills
+
+    toml = parse_toml(Path("pyproject.toml"))
+    info = PyProjectInfo.from_pyproject_toml(toml)
+    venv_skills = VenvSkills.from_dir(Path(".venv"))
+    for skill in venv_skills.filter_skills(info.dependencies):
+        print(f"{skill.skill.name}: {skill.skill.description}")

skilly-0.0.2a0/src/skilly/cli/util.py

@@ -0,0 +1,32 @@
+from typing import Sequence
+from pathlib import Path
+from cyclopts import App
+
+util_cli = App("util")
+
+
+@util_cli.command()
+def dependencies(
+    file: Path = Path("pyproject.toml"), dev: bool = False, extras: Sequence[str] = ()
+) -> None:
+    # Todo: Sequence[str] might be wrong here for now
+    from skilly.parsers import parse_toml, PyProjectInfo
+
+    toml = parse_toml(file)
+    info = PyProjectInfo.from_pyproject_toml(
+        toml, include_dev=dev, include_extras=extras
+    )
+    for dep in info.dependencies:
+        print(dep.name)
+
+
+@util_cli.command()
+def venv(path: Path = Path(".venv")) -> None:
+
+    from skilly.skills import VenvSkills
+
+    skills = VenvSkills.from_dir(path)
+    for skill in skills.skills:
+        print(
+            f"{skill.skill.name}[{skill.package_name}=={skill.package_version}]: {skill.skill.description}"
+        )

skilly-0.0.2a0/src/skilly/filesystem.py

@@ -0,0 +1,35 @@
+import os
+from pathlib import Path
+from typing import Protocol, Sequence, Final
+
+
+class FileSystem(Protocol):
+    def read_file(self, path: Path) -> str:
+        """Read a file and return its contents."""
+
+    def list_files(self, path: Path) -> Sequence[str]:
+        """List child entry names in a directory."""
+
+    def is_dir(self, path: Path) -> bool:
+        """Return whether the path is a directory."""
+
+    def resolve(self, path: Path) -> Path:
+        """Return a normalized absolute path."""
+
+
+class DefaultFileSystem(FileSystem):
+    def read_file(self, path: Path) -> str:
+        with open(path, encoding="utf-8") as file_handle:
+            return file_handle.read()
+
+    def list_files(self, path: Path) -> Sequence[str]:
+        return os.listdir(path)
+
+    def is_dir(self, path: Path) -> bool:
+        return os.path.isdir(path)
+
+    def resolve(self, path: Path) -> Path:
+        return path.resolve()
+
+
+DEFAULT_FILE_SYSTEM: Final[FileSystem] = DefaultFileSystem()

skilly-0.0.2a0/src/skilly/parsers.py

@@ -0,0 +1,54 @@
+import tomllib
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Sequence
+
+from packaging.requirements import Requirement
+
+from .filesystem import DEFAULT_FILE_SYSTEM, FileSystem
+
+
+@dataclass(frozen=True)
+class PyProjectInfo:
+    dependencies: list[Requirement]
+
+    @classmethod
+    def _get_extra_requirements(
+        cls,
+        toml: dict[str, Any],
+        extras: Sequence[str],
+    ) -> list[Requirement]:
+        dependency_groups = toml.get("dependency-groups", {})
+        extra_requirements = []
+        for extra in dependency_groups.keys():
+            if extra in extras:
+                for dep in dependency_groups[extra]:
+                    extra_requirements.append(Requirement(dep))
+
+        return extra_requirements
+
+    @classmethod
+    def from_pyproject_toml(
+        cls,
+        toml: dict[str, Any],
+        include_dev: bool = False,
+        include_extras: Sequence[str] = (),
+    ) -> "PyProjectInfo":
+        dependencies = []
+        for dep in toml.get("project", {}).get("dependencies", []):
+            dependencies.append(Requirement(dep))
+
+        extras = set(include_extras)
+        if include_dev:
+            extras.add("dev")
+
+        dependencies.extend(cls._get_extra_requirements(toml, extras))
+        return cls(dependencies=dependencies)
+
+
+def parse_toml(
+    path: Path,
+    file_system: FileSystem = DEFAULT_FILE_SYSTEM,
+) -> dict[str, Any]:
+    data = file_system.read_file(path)
+    return tomllib.loads(data)