python-skills 1.0.0__tar.gz

python_skills-1.0.0/.gitignore

@@ -0,0 +1,38 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Linting
+.ruff_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project
+.python-skills/
+*.log

python_skills-1.0.0/LICENSE

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

python_skills-1.0.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.5
+Name: python-skills
+Version: 1.0.0
+Summary: Python engineering skills for AI coding agents
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Python Skills
+
+Python engineering skills for AI coding agents.
+
+## Overview
+
+Python Skills is a comprehensive knowledge base of 69 skills across 10 categories, designed to help AI coding agents write better Python code. It supports 16 AI coding agents via a unified adapter system.
+
+## Supported Agents
+
+| Agent | Skills Dir | Native Dir | Type |
+|-------|-----------|------------|------|
+| **OpenCode** | `.agents/skills/` | `.opencode/skills/` | A-NativeSkills |
+| **Windsurf** | `.agents/skills/` | `.windsurf/skills/` | A-NativeSkills |
+| **VS Code / Copilot** | `.agents/skills/` | `.github/skills/` | A-NativeSkills |
+| **Gemini** | `.agents/skills/` | `.gemini/skills/` | A-NativeSkills |
+| **Roo Code** | `.agents/skills/` | `.roo/skills/` | A-NativeSkills |
+| **Codex** | `.agents/skills/` | — | A-NativeSkills |
+| **Goose** | `.agents/skills/` | — | A-NativeSkills |
+| **Junie (JetBrains)** | `.agents/skills/` | `.junie/skills/` | A-NativeSkills |
+| **Zed** | `.agents/skills/` | — | A-NativeSkills |
+| **Continue** | `.continue/rules/` | — | B-NativeRules |
+| **Aider** | `PYTHON_SKILLS.md` | `.aider.conf.yml` | D-Config |
+| **Claude Code** | `.claude/skills/` | — | A-NativeSkills |
+| **Cursor** | `.cursor/rules/` | — | B-NativeRules |
+| **Kiro** | `.kiro/skills/` | — | A-NativeSkills |
+| **Cline** | `.agents/skills/` | `.clinerules` | A-NativeSkills |
+| **Universal** | `AGENTS.md` | — | E-Universal |
+
+## Shared Skills Directory
+
+Targets that support the [Agent Skills specification](https://github.com/opencode-ai/agent-skills) share a single `.agents/skills/` directory. Each target also gets its own vendor-specific directory (e.g., `.opencode/skills/`). Installing multiple targets produces only 67 skill directories, not 67 per target.
+
+## Skill Categories
+
+- **Core**: Python language fundamentals (variables, control flow, functions, data structures, OOP)
+- **Stdlib**: Standard library modules (argparse, collections, datetime, functools, itertools, json, logging, pathlib, re, statistics, subprocess)
+- **Generation**: Code generation patterns (type hints, protocols, async, error handling, validation, workflow)
+- **Engineering**: Production engineering (CLI apps, configuration, databases, HTTP clients, packaging, virtual environments)
+- **Quality**: Code quality standards (abstractions, comments, documentation, duplication, functions, maintainability, naming, readability, type annotations)
+- **Security**: Security engineering (auth boundaries, command injection, dependency risks, file handling, input validation, path traversal, secrets, SQL injection, unsafe deserialization)
+- **Testing**: Testing methodologies (async tests, coverage, edge cases, fixtures/mocks, organization, parameterized, regression tests)
+- **Refactoring**: Safe refactoring patterns (behavior preservation, incremental, interface stability, safe refactoring)
+- **Debugging**: Debugging techniques (common bugs, inspection, root cause analysis)
+- **Anti-patterns**: Anti-pattern prevention
+
+## Installation
+
+```bash
+pip install python-skills
+```
+
+Or from source:
+```bash
+git clone https://github.com/FoxPink-dev/python-skills.git
+cd python-skills
+pip install -e .
+```
+
+## Usage
+
+```bash
+# Detect available agents
+python -m python_skills detect
+
+# Install for all compatible agents
+python -m python_skills install --auto
+
+# Install for specific targets
+python -m python_skills install --target opencode --target windsurf
+
+# Sync installed skills with latest
+python -m python_skills sync
+
+# Check installation status
+python -m python_skills status
+
+# Uninstall from all targets
+python -m python_skills uninstall --auto
+```
+
+## License
+
+MIT License

python_skills-1.0.0/README.md

@@ -0,0 +1,84 @@
+# Python Skills
+
+Python engineering skills for AI coding agents.
+
+## Overview
+
+Python Skills is a comprehensive knowledge base of 69 skills across 10 categories, designed to help AI coding agents write better Python code. It supports 16 AI coding agents via a unified adapter system.
+
+## Supported Agents
+
+| Agent | Skills Dir | Native Dir | Type |
+|-------|-----------|------------|------|
+| **OpenCode** | `.agents/skills/` | `.opencode/skills/` | A-NativeSkills |
+| **Windsurf** | `.agents/skills/` | `.windsurf/skills/` | A-NativeSkills |
+| **VS Code / Copilot** | `.agents/skills/` | `.github/skills/` | A-NativeSkills |
+| **Gemini** | `.agents/skills/` | `.gemini/skills/` | A-NativeSkills |
+| **Roo Code** | `.agents/skills/` | `.roo/skills/` | A-NativeSkills |
+| **Codex** | `.agents/skills/` | — | A-NativeSkills |
+| **Goose** | `.agents/skills/` | — | A-NativeSkills |
+| **Junie (JetBrains)** | `.agents/skills/` | `.junie/skills/` | A-NativeSkills |
+| **Zed** | `.agents/skills/` | — | A-NativeSkills |
+| **Continue** | `.continue/rules/` | — | B-NativeRules |
+| **Aider** | `PYTHON_SKILLS.md` | `.aider.conf.yml` | D-Config |
+| **Claude Code** | `.claude/skills/` | — | A-NativeSkills |
+| **Cursor** | `.cursor/rules/` | — | B-NativeRules |
+| **Kiro** | `.kiro/skills/` | — | A-NativeSkills |
+| **Cline** | `.agents/skills/` | `.clinerules` | A-NativeSkills |
+| **Universal** | `AGENTS.md` | — | E-Universal |
+
+## Shared Skills Directory
+
+Targets that support the [Agent Skills specification](https://github.com/opencode-ai/agent-skills) share a single `.agents/skills/` directory. Each target also gets its own vendor-specific directory (e.g., `.opencode/skills/`). Installing multiple targets produces only 67 skill directories, not 67 per target.
+
+## Skill Categories
+
+- **Core**: Python language fundamentals (variables, control flow, functions, data structures, OOP)
+- **Stdlib**: Standard library modules (argparse, collections, datetime, functools, itertools, json, logging, pathlib, re, statistics, subprocess)
+- **Generation**: Code generation patterns (type hints, protocols, async, error handling, validation, workflow)
+- **Engineering**: Production engineering (CLI apps, configuration, databases, HTTP clients, packaging, virtual environments)
+- **Quality**: Code quality standards (abstractions, comments, documentation, duplication, functions, maintainability, naming, readability, type annotations)
+- **Security**: Security engineering (auth boundaries, command injection, dependency risks, file handling, input validation, path traversal, secrets, SQL injection, unsafe deserialization)
+- **Testing**: Testing methodologies (async tests, coverage, edge cases, fixtures/mocks, organization, parameterized, regression tests)
+- **Refactoring**: Safe refactoring patterns (behavior preservation, incremental, interface stability, safe refactoring)
+- **Debugging**: Debugging techniques (common bugs, inspection, root cause analysis)
+- **Anti-patterns**: Anti-pattern prevention
+
+## Installation
+
+```bash
+pip install python-skills
+```
+
+Or from source:
+```bash
+git clone https://github.com/FoxPink-dev/python-skills.git
+cd python-skills
+pip install -e .
+```
+
+## Usage
+
+```bash
+# Detect available agents
+python -m python_skills detect
+
+# Install for all compatible agents
+python -m python_skills install --auto
+
+# Install for specific targets
+python -m python_skills install --target opencode --target windsurf
+
+# Sync installed skills with latest
+python -m python_skills sync
+
+# Check installation status
+python -m python_skills status
+
+# Uninstall from all targets
+python -m python_skills uninstall --auto
+```
+
+## License
+
+MIT License

python_skills-1.0.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "python-skills"
+version = "1.0.0"
+description = "Python engineering skills for AI coding agents"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.0",
+    "pyyaml>=6.0",
+    "rich>=13.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "ruff>=0.5",
+    "mypy>=1.0",
+]
+
+[project.scripts]
+python-skills = "python_skills.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["python_skills", "skills"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "python_skills/**",
+    "skills/**",
+    "README.md",
+    "LICENSE",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --strict-markers --strict-config --tb=short"
+asyncio_mode = "auto"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+select = ["E", "F", "I", "N", "UP", "W", "C4", "DTZ", "T10", "PTH", "S", "B", "A", "C", "Q", "TID", "RUF"]
+fixable = ["ALL"]
+unfixable = []
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "lf"
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+strict_optional = true
+show_error_codes = true
+namespace_packages = true

python_skills-1.0.0/python_skills/__init__.py

@@ -0,0 +1,10 @@
+"""Python Skills - Python engineering skills for AI coding agents."""
+
+from importlib.metadata import version as _metadata_version
+
+try:
+    __version__ = _metadata_version("python-skills")
+except Exception:
+    __version__ = "0.0.0"
+
+__all__ = ["__version__"]

python_skills-1.0.0/python_skills/__main__.py

@@ -0,0 +1,6 @@
+"""Main entry point for python-skills CLI."""
+
+from python_skills.cli import main
+
+if __name__ == "__main__":
+    main()

python_skills-1.0.0/python_skills/adapters/__init__.py

@@ -0,0 +1,48 @@
+"""Adapters for python-skills target environments."""
+
+from ..config import Target
+
+
+def get_adapter(target: Target, project_root, skills_registry, lock_manager, config):
+    """Factory function to get adapter instance by target."""
+    from .aider_adapter import AiderAdapter
+    from .claude import ClaudeAdapter
+    from .cline import ClineAdapter
+    from .codex import CodexAdapter
+    from .continue_adapter import ContinueAdapter
+    from .cursor import CursorAdapter
+    from .gemini import GeminiAdapter
+    from .goose import GooseAdapter
+    from .junie import JunieAdapter
+    from .kiro import KiroAdapter
+    from .opencode import OpenCodeAdapter
+    from .roo import RooAdapter
+    from .universal import UniversalAdapter
+    from .vscode import VSCodeAdapter
+    from .windsurf import WindsurfAdapter
+    from .zed import ZedAdapter
+
+    adapters = {
+        Target.CLAUDE: ClaudeAdapter,
+        Target.CURSOR: CursorAdapter,
+        Target.KIRO: KiroAdapter,
+        Target.CLINE: ClineAdapter,
+        Target.UNIVERSAL: UniversalAdapter,
+        Target.OPENCODE: OpenCodeAdapter,
+        Target.WINDSURF: WindsurfAdapter,
+        Target.VSCODE: VSCodeAdapter,
+        Target.ROO: RooAdapter,
+        Target.GEMINI: GeminiAdapter,
+        Target.CODEX: CodexAdapter,
+        Target.JETBRAINS: JunieAdapter,
+        Target.GOOSE: GooseAdapter,
+        Target.ZED: ZedAdapter,
+        Target.CONTINUE: ContinueAdapter,
+        Target.AIDER: AiderAdapter,
+    }
+
+    adapter_cls = adapters.get(target)
+    if adapter_cls is None:
+        raise ValueError(f"Unknown target: {target}")
+
+    return adapter_cls(project_root, skills_registry, lock_manager, config)