skillxp 0.1.0__py3-none-win_amd64.whl

skillxp/__init__.py

@@ -0,0 +1,54 @@
+"""Python wrapper around the skillxp Go CLI, which observes how agent
+harnesses (Antigravity CLI, Claude Code, Codex CLI) load and activate
+Agent Skills.
+
+The wheel bundles the real binary; the ``skillxp`` console script is a
+transparent passthrough. The CLI writes its results to disk
+(``observation.json``, ``session.json``, archived transcripts) rather
+than printing a JSON envelope, so this package carries no invocation
+API: run the CLI via ``subprocess`` with ``binary_path()`` and read the
+bundle. Set SKILLXP_BINARY to override which binary is invoked.
+"""
+
+import os
+import subprocess
+import sys
+
+
+class NotInstalledError(RuntimeError):
+    """No bundled binary for this platform (and no SKILLXP_BINARY override)."""
+
+
+def binary_path():
+    """Return the path of the skillxp binary this wrapper invokes."""
+    override = os.environ.get("SKILLXP_BINARY")
+    if override:
+        return override
+    exe = "skillxp.exe" if sys.platform == "win32" else "skillxp"
+    path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "bin", exe)
+    if not os.path.exists(path):
+        raise NotInstalledError(
+            "skillxp: no bundled binary for this platform; install the Go "
+            "CLI instead (https://github.com/agent-ecosystem/skillxp) and "
+            "set SKILLXP_BINARY"
+        )
+    # Some installers drop the exec bit on package data; restore best-effort.
+    if os.name == "posix" and not os.access(path, os.X_OK):
+        try:
+            os.chmod(path, 0o755)
+        except OSError:
+            pass
+    return path
+
+
+def _main():
+    """Console-script entry: transparent passthrough to the binary."""
+    try:
+        binary = binary_path()
+    except NotInstalledError as err:
+        print(err, file=sys.stderr)
+        raise SystemExit(69)  # EX_UNAVAILABLE: no usable binary
+    argv = [binary] + sys.argv[1:]
+    if os.name == "posix":
+        os.execv(binary, argv)
+    raise SystemExit(subprocess.call(argv))

skillxp-0.1.0.dist-info/METADATA

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: skillxp
+Version: 0.1.0
+Summary: Observes how agent harnesses (Antigravity CLI, Claude Code, Codex CLI) load and activate Agent Skills. Python wrapper around the skillxp Go CLI.
+Author: Dachary Carey
+License: MIT
+Project-URL: Homepage, https://github.com/agent-ecosystem/skillxp
+Project-URL: Repository, https://github.com/agent-ecosystem/skillxp
+Keywords: agent,skills,agent-skills,claude-code,codex,antigravity,headless
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# skillxp
+
+Python wrapper around
+[skillxp](https://github.com/agent-ecosystem/skillxp), a Go CLI that
+observes how agent harnesses (Antigravity CLI, Claude Code, Codex CLI)
+load and activate [Agent Skills](https://agentskills.io): it installs a
+skill in a fresh fixture, invokes the harness headlessly, and reports
+what actually reached the model, with transcript evidence.
+
+The wheel bundles the real Go binary for your platform.
+
+## CLI
+
+```bash
+pip install skillxp
+skillxp harnesses
+
+skillxp observe -harness claude-code -install ./my-skill \
+  -prompt "Activate the my-skill skill and follow its instructions." \
+  -activation -trace "PHRASE-IN-BODY-1234" -out out/
+```
+
+Identical to the Go CLI — see the
+[project README](https://github.com/agent-ecosystem/skillxp) for the full
+surface and the observation bundle layout.
+
+## API
+
+The CLI writes its results to disk (`observation.json`, `session.json`,
+archived transcripts) rather than printing a JSON envelope, so this
+package carries no invocation API. Run the CLI via `subprocess` and read
+the bundle; `binary_path()` exposes the bundled binary:
+
+```python
+import subprocess
+import skillxp
+
+subprocess.run([skillxp.binary_path(), "observe", "-harness", "claude-code", ...])
+```
+
+Set `SKILLXP_BINARY` to override which binary the wrapper invokes.

skillxp-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+skillxp/__init__.py,sha256=2ULIsZrqfOOr8ZfxGOGSb0GlZ0ZhOp4lj8VQfPFHuok,1956
+skillxp/bin/skillxp.exe,sha256=kubAs2JagH8D1z9b26CBnfubhJGHEjCOFt-LOLcitCk,3320320
+skillxp-0.1.0.dist-info/METADATA,sha256=K7aUDfr1nvqWmGPQRGlPlmy61VClhNL3dafGVcx5MfU,1819
+skillxp-0.1.0.dist-info/WHEEL,sha256=5s7VO_HUPfjwcO4LINqxGe8JSFZAGgaurQKPGA4cx_g,97
+skillxp-0.1.0.dist-info/entry_points.txt,sha256=8zrZ_9CeuOdFiAudHjb6SaUsBb2fuBk5zVemCUKIfHE,42
+skillxp-0.1.0.dist-info/top_level.txt,sha256=65Iy2aflfmM5WUIsUnQVbUlxO7z2PwzwwgD5-AXA7fA,8
+skillxp-0.1.0.dist-info/RECORD,,

skillxp-0.1.0.dist-info/WHEEL

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

skillxp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+skillxp = skillxp:_main

skillxp-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+skillxp