SkillLink 0.1.0__tar.gz

skilllink-0.1.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: SkillLink
+Version: 0.1.0
+Summary: A Modern way to sync skills
+Author: Tristan McBride Sr.
+Author-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
+Maintainer-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/TristanMcBrideSr
+Keywords: AI,Agents,Skills,Productivity,Automation,Voice Assistant,Chatbot,LLM,Large Language Model
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Dynamic: author
+
+
+---
+
+# SkillLink
+
+**SkillLink** is a flexible Python utility for syncing code files (skills, scripts, or any directory content) from a folder in a GitHub repository to your local directory.
+Supports public and private repos, selective file syncing, local-over-remote file protection, and easy integration.
+
+---
+
+## Features
+
+* **Sync entire folders** or select specific files.
+* **Skip or override** existing local files.
+* **Supports private repos** (via GitHub token).
+* **Branch selection**—sync from any branch, not just master/main.
+* **Simple, readable code**—ready to drop into any project.
+* **Preserves your local changes** by default.
+
+---
+
+## Installation
+
+Simply copy `SkillLink` into your project, or package as you like.
+
+Dependencies:
+
+* Python 3.10+
+* `requests`
+
+---
+
+## Usage
+
+### **1. Basic Example (Sync All Files)**
+
+```python
+from skilllink import SkillLink
+
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+syncer.startSync()
+```
+
+### **2. Sync Only Specific Files**
+
+```python
+syncer = SkillLink(
+    githubRepo='your-username/your-repo',
+    repoFolder='MySkills',
+    localDir='./skills'
+)
+# Only sync 'weather.py' and 'research.py'
+syncer.startSync(skillList=['weather', 'research'])
+```
+
+### **3. Override Existing Local Files**
+
+```python
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+# Force override any local file with the downloaded version
+syncer.startSync(override=True)
+```
+
+### **4. Sync From a Private Repo**
+
+```python
+syncer = SkillLink(
+    githubRepo='your-username/private-repo',
+    repoFolder='MySkills',
+    localDir='./skills'
+)
+# Provide a GitHub token (classic or fine-grained with repo read access)
+syncer.startSync(githubToken='YOUR_GITHUB_TOKEN')
+```
+
+### **5. Sync From a Different Branch**
+
+```python
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+syncer.startSync(branch='dev')  # Sync from 'dev' branch
+```
+
+---
+
+## Parameters
+
+### `SkillLink` constructor
+
+* **githubRepo**: GitHub repo in the form `"owner/repo"` (required)
+* **repoFolder**: Folder inside the repo to sync from (required)
+* **localDir**: Local directory to sync files to (required)
+
+### `startSync(**kwargs)`
+
+* **skillList** (`list`): Only these files will be synced (by name, `.py` optional).
+* **override** (`bool`): If `True`, always overwrite existing local files.
+* **githubToken** (`str`): Personal GitHub token for private repo access.
+* **branch** (`str`): Branch to sync from (default `"master"`).
+
+---
+
+## How It Works
+
+* Downloads a zip of the specified repo+branch.
+* Extracts just the folder you specify.
+* Copies each file:
+
+  * **By default:** only new files are copied (existing files are untouched).
+  * **With `override=True`:** always overwrites local files.
+* Lets you pick which files to sync, or sync all.
+
+---
+
+## Error Handling
+
+* Raises if folders/files are missing.
+* Logs sync actions and errors to Python logger.
+* Skips files that already exist locally, unless `override` is set.
+
+---
+
+## Example: Complete Workflow
+
+```python
+syncer = SkillLink(
+    githubRepo='my-org/myrepo',
+    repoFolder='skills',
+    localDir='./skills'
+)
+syncer.startSync(
+    skillList=['my_skill', 'other_skill.py'],
+    override=False,
+    githubToken=os.getenv('GITHUB_TOKEN'),
+    branch='main'
+)
+```
+
+---
+
+## License
+
+This project is licensed under the [Apache License, Version 2.0](LICENSE).
+Copyright 2025 Tristan McBride Sr.
+
+---
+
+**Authors:**
+- Tristan McBride Sr.
+- Sybil
+

skilllink-0.1.0/README.md

@@ -0,0 +1,162 @@
+
+---
+
+# SkillLink
+
+**SkillLink** is a flexible Python utility for syncing code files (skills, scripts, or any directory content) from a folder in a GitHub repository to your local directory.
+Supports public and private repos, selective file syncing, local-over-remote file protection, and easy integration.
+
+---
+
+## Features
+
+* **Sync entire folders** or select specific files.
+* **Skip or override** existing local files.
+* **Supports private repos** (via GitHub token).
+* **Branch selection**—sync from any branch, not just master/main.
+* **Simple, readable code**—ready to drop into any project.
+* **Preserves your local changes** by default.
+
+---
+
+## Installation
+
+Simply copy `SkillLink` into your project, or package as you like.
+
+Dependencies:
+
+* Python 3.10+
+* `requests`
+
+---
+
+## Usage
+
+### **1. Basic Example (Sync All Files)**
+
+```python
+from skilllink import SkillLink
+
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+syncer.startSync()
+```
+
+### **2. Sync Only Specific Files**
+
+```python
+syncer = SkillLink(
+    githubRepo='your-username/your-repo',
+    repoFolder='MySkills',
+    localDir='./skills'
+)
+# Only sync 'weather.py' and 'research.py'
+syncer.startSync(skillList=['weather', 'research'])
+```
+
+### **3. Override Existing Local Files**
+
+```python
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+# Force override any local file with the downloaded version
+syncer.startSync(override=True)
+```
+
+### **4. Sync From a Private Repo**
+
+```python
+syncer = SkillLink(
+    githubRepo='your-username/private-repo',
+    repoFolder='MySkills',
+    localDir='./skills'
+)
+# Provide a GitHub token (classic or fine-grained with repo read access)
+syncer.startSync(githubToken='YOUR_GITHUB_TOKEN')
+```
+
+### **5. Sync From a Different Branch**
+
+```python
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+syncer.startSync(branch='dev')  # Sync from 'dev' branch
+```
+
+---
+
+## Parameters
+
+### `SkillLink` constructor
+
+* **githubRepo**: GitHub repo in the form `"owner/repo"` (required)
+* **repoFolder**: Folder inside the repo to sync from (required)
+* **localDir**: Local directory to sync files to (required)
+
+### `startSync(**kwargs)`
+
+* **skillList** (`list`): Only these files will be synced (by name, `.py` optional).
+* **override** (`bool`): If `True`, always overwrite existing local files.
+* **githubToken** (`str`): Personal GitHub token for private repo access.
+* **branch** (`str`): Branch to sync from (default `"master"`).
+
+---
+
+## How It Works
+
+* Downloads a zip of the specified repo+branch.
+* Extracts just the folder you specify.
+* Copies each file:
+
+  * **By default:** only new files are copied (existing files are untouched).
+  * **With `override=True`:** always overwrites local files.
+* Lets you pick which files to sync, or sync all.
+
+---
+
+## Error Handling
+
+* Raises if folders/files are missing.
+* Logs sync actions and errors to Python logger.
+* Skips files that already exist locally, unless `override` is set.
+
+---
+
+## Example: Complete Workflow
+
+```python
+syncer = SkillLink(
+    githubRepo='my-org/myrepo',
+    repoFolder='skills',
+    localDir='./skills'
+)
+syncer.startSync(
+    skillList=['my_skill', 'other_skill.py'],
+    override=False,
+    githubToken=os.getenv('GITHUB_TOKEN'),
+    branch='main'
+)
+```
+
+---
+
+## License
+
+This project is licensed under the [Apache License, Version 2.0](LICENSE).
+Copyright 2025 Tristan McBride Sr.
+
+---
+
+**Authors:**
+- Tristan McBride Sr.
+- Sybil
+

skilllink-0.1.0/SkillLink.egg-info/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: SkillLink
+Version: 0.1.0
+Summary: A Modern way to sync skills
+Author: Tristan McBride Sr.
+Author-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
+Maintainer-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/TristanMcBrideSr
+Keywords: AI,Agents,Skills,Productivity,Automation,Voice Assistant,Chatbot,LLM,Large Language Model
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Dynamic: author
+
+
+---
+
+# SkillLink
+
+**SkillLink** is a flexible Python utility for syncing code files (skills, scripts, or any directory content) from a folder in a GitHub repository to your local directory.
+Supports public and private repos, selective file syncing, local-over-remote file protection, and easy integration.
+
+---
+
+## Features
+
+* **Sync entire folders** or select specific files.
+* **Skip or override** existing local files.
+* **Supports private repos** (via GitHub token).
+* **Branch selection**—sync from any branch, not just master/main.
+* **Simple, readable code**—ready to drop into any project.
+* **Preserves your local changes** by default.
+
+---
+
+## Installation
+
+Simply copy `SkillLink` into your project, or package as you like.
+
+Dependencies:
+
+* Python 3.10+
+* `requests`
+
+---
+
+## Usage
+
+### **1. Basic Example (Sync All Files)**
+
+```python
+from skilllink import SkillLink
+
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+syncer.startSync()
+```
+
+### **2. Sync Only Specific Files**
+
+```python
+syncer = SkillLink(
+    githubRepo='your-username/your-repo',
+    repoFolder='MySkills',
+    localDir='./skills'
+)
+# Only sync 'weather.py' and 'research.py'
+syncer.startSync(skillList=['weather', 'research'])
+```
+
+### **3. Override Existing Local Files**
+
+```python
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+# Force override any local file with the downloaded version
+syncer.startSync(override=True)
+```
+
+### **4. Sync From a Private Repo**
+
+```python
+syncer = SkillLink(
+    githubRepo='your-username/private-repo',
+    repoFolder='MySkills',
+    localDir='./skills'
+)
+# Provide a GitHub token (classic or fine-grained with repo read access)
+syncer.startSync(githubToken='YOUR_GITHUB_TOKEN')
+```
+
+### **5. Sync From a Different Branch**
+
+```python
+syncer = SkillLink(
+    githubRepo='TristanMcBrideSr/SkillForge',
+    repoFolder='SkillForge',
+    localDir='./skills'
+)
+syncer.startSync(branch='dev')  # Sync from 'dev' branch
+```
+
+---
+
+## Parameters
+
+### `SkillLink` constructor
+
+* **githubRepo**: GitHub repo in the form `"owner/repo"` (required)
+* **repoFolder**: Folder inside the repo to sync from (required)
+* **localDir**: Local directory to sync files to (required)
+
+### `startSync(**kwargs)`
+
+* **skillList** (`list`): Only these files will be synced (by name, `.py` optional).
+* **override** (`bool`): If `True`, always overwrite existing local files.
+* **githubToken** (`str`): Personal GitHub token for private repo access.
+* **branch** (`str`): Branch to sync from (default `"master"`).
+
+---
+
+## How It Works
+
+* Downloads a zip of the specified repo+branch.
+* Extracts just the folder you specify.
+* Copies each file:
+
+  * **By default:** only new files are copied (existing files are untouched).
+  * **With `override=True`:** always overwrites local files.
+* Lets you pick which files to sync, or sync all.
+
+---
+
+## Error Handling
+
+* Raises if folders/files are missing.
+* Logs sync actions and errors to Python logger.
+* Skips files that already exist locally, unless `override` is set.
+
+---
+
+## Example: Complete Workflow
+
+```python
+syncer = SkillLink(
+    githubRepo='my-org/myrepo',
+    repoFolder='skills',
+    localDir='./skills'
+)
+syncer.startSync(
+    skillList=['my_skill', 'other_skill.py'],
+    override=False,
+    githubToken=os.getenv('GITHUB_TOKEN'),
+    branch='main'
+)
+```
+
+---
+
+## License
+
+This project is licensed under the [Apache License, Version 2.0](LICENSE).
+Copyright 2025 Tristan McBride Sr.
+
+---
+
+**Authors:**
+- Tristan McBride Sr.
+- Sybil
+

skilllink-0.1.0/SkillLink.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+setup.py
+SkillLink.egg-info/PKG-INFO
+SkillLink.egg-info/SOURCES.txt
+SkillLink.egg-info/dependency_links.txt
+SkillLink.egg-info/requires.txt
+SkillLink.egg-info/top_level.txt

skilllink-0.1.0/SkillLink.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

skilllink-0.1.0/SkillLink.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

skilllink-0.1.0/SkillLink.egg-info/top_level.txt

@@ -0,0 +1 @@
+

skilllink-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "SkillLink"
+version = "0.1.0"
+description = "A Modern way to sync skills"
+authors = [
+  { name="Tristan McBride Sr.", email = "142635792+TristanMcBrideSr@users.noreply.github.com" },
+]
+maintainers = [
+  {name = "Tristan McBride Sr.", email = "142635792+TristanMcBrideSr@users.noreply.github.com"}
+]
+readme = "README.md"
+license = "Apache-2.0"
+license-files = ["LICEN[CS]E.*"]
+requires-python = ">=3.10"
+dependencies = [
+    "requests",
+]
+# Optional: Use this if you want to expose keywords for searchability
+keywords = [
+    "AI", "Agents", "Skills", "Productivity", "Automation", "Voice Assistant", "Chatbot", "LLM", "Large Language Model"
+]
+# Optional: Classifiers for PyPI
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+]
+
+[project.urls]
+Homepage = "https://github.com/TristanMcBrideSr"

skilllink-0.1.0/setup.cfg

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

skilllink-0.1.0/setup.py

@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+from setuptools import setup, find_packages
+
+setup(
+    name="SkillLink",
+    version="0.1.0",
+    packages=find_packages(),
+    include_package_data=True,
+    install_requires=[
+        "requests",
+    ],
+    author="Tristan McBride Sr.",
+    author_email="TristanMcBrideSr@users.noreply.github.com",
+    description="A Modern way to sync skills",
+)