site2skill 0.2.0b2__py3-none-win_amd64.whl

site2skill/__init__.py

@@ -0,0 +1,43 @@
+"""site2skill - Turn any documentation website into a Claude Agent Skill."""
+
+import os
+import stat
+import subprocess
+import sys
+from pathlib import Path
+
+
+def get_binary_path() -> Path:
+    """Return the path to the bundled binary."""
+    package_dir = Path(__file__).parent
+    binary_name = "site2skill.exe" if sys.platform == "win32" else "site2skill"
+    binary = package_dir / "bin" / binary_name
+
+    # Ensure binary is executable on Unix
+    if sys.platform != "win32" and binary.exists():
+        current_mode = os.stat(binary).st_mode
+        if not (current_mode & stat.S_IXUSR):
+            os.chmod(binary, current_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+
+    return binary
+
+
+def main():
+    """Execute the bundled binary."""
+    binary = get_binary_path()
+
+    if not binary.exists():
+        print(f"Error: Binary not found at {binary}", file=sys.stderr)
+        sys.exit(1)
+
+    if sys.platform == "win32":
+        # On Windows, use subprocess to properly handle signals
+        result = subprocess.run([str(binary)] + sys.argv[1:])
+        sys.exit(result.returncode)
+    else:
+        # On Unix, exec replaces the process
+        os.execvp(str(binary), [str(binary)] + sys.argv[1:])
+
+
+if __name__ == "__main__":
+    main()

site2skill/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running site2skill as a module."""
+
+from site2skill import main
+
+if __name__ == "__main__":
+    main()

site2skill-0.2.0b2.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: site2skill
+Version: 0.2.0b2
+Summary: Turn any documentation website into a Claude Agent Skill
+Author-email: laiso <laiso@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,claude,cli,documentation,rust,skill
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Rust
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# site2skill
+
+**Turn any documentation website into a Claude Agent Skill.**
+
+`site2skill` is a tool that scrapes a documentation website, converts it to Markdown, and packages it as a Claude [Agent Skill](https://www.anthropic.com/news/skills) (ZIP format) with a proper `SKILL.md` entry point.
+
+Agent Skills are dynamically loaded knowledge modules that Claude uses on demand. They work across Claude Code, Claude apps, and the API.
+
+## Installation
+
+**Requirements:**
+*   **Python 3.10+**
+*   **wget**: Must be installed and available in your PATH.
+    *   macOS: `brew install wget`
+    *   Linux: `apt install wget`
+    *   Windows: Use WSL, or install via `choco install wget` / `scoop install wget`
+
+### Install from PyPI
+
+```bash
+# Standard installation with pip
+pip install site2skill
+
+# Or with uv
+uv tool install site2skill
+```
+
+### Run without Installation
+
+```bash
+# Run directly with uvx
+uvx site2skill <URL> <SKILL_NAME>
+```
+
+### Install from GitHub (Latest)
+
+```bash
+pip install git+https://github.com/laiso/site2skill.git
+uvx --from git+https://github.com/laiso/site2skill site2skill <URL> <SKILL_NAME>
+```
+
+## Usage
+
+```bash
+# Basic usage
+site2skill <URL> <SKILL_NAME>
+
+# Example: Create a skill for PAY.JP
+site2skill https://docs.pay.jp/v1/ payjp
+
+# Example: Create a skill for uv documentation
+site2skill https://docs.astral.sh/uv/ uv-docs
+
+# Target specific agent (sets default output directory)
+site2skill <URL> <SKILL_NAME> --target claude-desktop
+```
+
+## CLI Options
+
+```
+site2skill <URL> <SKILL_NAME> [options]
+
+Options:
+  --target           Target agent (claude|claude-desktop|cursor|gemini|codex). Sets default output directory
+  --output, -o       Base output directory for skill structure (overrides target default)
+  --skill-output     Output directory for .skill file (default: .)
+  --temp-dir         Temporary directory for processing (default: build)
+  --skip-fetch       Skip the download step (use existing files in temp dir)
+  --clean            Clean up temporary directory after completion
+```
+
+## How it works
+
+1.  **Fetch**: Downloads the documentation site recursively using `wget`.
+2.  **Convert**: Converts HTML pages to Markdown using `beautifulsoup4` and `markdownify`.
+3.  **Normalize**: Cleans up links and formatting.
+4.  **Validate**: Checks the skill structure and size limits.
+5.  **Package**: Generates `SKILL.md` and zips everything into a `.skill` file.
+
+## Output
+
+The tool generates a skill directory in `.claude/skills/<skill_name>/` containing:
+
+```
+<skill_name>/
+├── SKILL.md           # Entry point with usage instructions
+├── references/        # Markdown documentation files (preferred)
+└── scripts/
+    └── search_docs.py # Search tool for documentation
+```
+
+Additionally, a `<skill_name>.skill` file (ZIP archive) is created in the current directory.
+
+Legacy note: older skills may use `docs/` instead of `references/`. The search tool and validator
+now support both, preferring `references/` when present.
+
+### Search Tool
+
+Each generated skill includes a search script:
+
+```bash
+python scripts/search_docs.py "<query>"
+python scripts/search_docs.py "<query>" --json --max-results 5
+```
+
+## License
+
+MIT

site2skill-0.2.0b2.dist-info/RECORD

@@ -0,0 +1,8 @@
+site2skill/__init__.py,sha256=neB2BGgKk7FQbIJlVP0prbHilf33u8Hhrv4-KYT8Qcw,1295
+site2skill/__main__.py,sha256=u2WGnS0AawJNAvAniYKnk0tlXVsXW6fwRandNq-CsjI,128
+site2skill/bin/site2skill.exe,sha256=_VzYFKY1plYu-kRoNsfDaV_GGMGhQY1sjE5hYOf90RY,6687232
+site2skill-0.2.0b2.dist-info/METADATA,sha256=FF43uNh-Hpr19lUHQdJ59CKqsnr8bP3UTGCPySOXSmE,3852
+site2skill-0.2.0b2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+site2skill-0.2.0b2.dist-info/entry_points.txt,sha256=dGti9y6iPFjQ7QFqhnTdSVIdYWZT36HRM4LVR7xVA_4,47
+site2skill-0.2.0b2.dist-info/licenses/LICENSE,sha256=WQQK6cACZjWJwBIlcfnlbpAvJbiKajTl_Mdphg1IsFs,1083
+site2skill-0.2.0b2.dist-info/RECORD,,

site2skill-0.2.0b2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

site2skill-0.2.0b2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+site2skill = site2skill:main

site2skill-0.2.0b2.dist-info/licenses/LICENSE

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