Neo python
Neo Skills 是專為現代 AI Agent 設計的全方位能力擴充套件。本專案透過標準化的通訊架構,為 AI 代理安裝可插拔的「技能模組 (Skills)」,使其不僅僅是一個聊天機器人,而是能轉化為具備「感知-推理-行動」能力的多領域專家。
npx -y skills add Benknightdark/neo-skills --skill neo-pythonAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use this skill when writing, reviewing, debugging, or architecting Python 3.10+ code, including type hints, structural pattern matching, dataclasses, async/task groups, packaging-aware project structure, testability, and maintainability.
SKILL.md
3.7 KB, as published. Nobody here has run it
Python 3.10+ Expert Skill
Trigger On
- The user asks to write, debug, review, or refactor Python code.
- Working in a repository containing
*.py,pyproject.toml,requirements.txt,Pipfile, orpoetry.lock. - Requires asynchronous programming (
asyncio), type hinting, or modern Python feature recommendations. - The project needs setup for testing frameworks (
pytest) or static analysis tools (ruff,mypy).
Workflow
- Perceive:
- Inspect the project root to identify package management tools:
pyproject.toml(Poetry/PDM/Ruff),requirements.txt(pip), orenvironment.yml(Conda). - Probe for Python version requirements (ensure compatibility with 3.10+ minimum).
- Identify the application type: Web API (FastAPI, Flask, Django), Data Science (Pandas, PyTorch), or CLI tools.
- Inspect the project root to identify package management tools:
- Reason:
- Evaluate if the current code follows modern Python (3.10+) idioms (e.g.,
match/case,|union types). - Decide if type checking (MyPy/Pyright) or auto-formatting (Ruff/Black) needs to be introduced.
- Recommend appropriate architectural patterns based on project scale.
- Evaluate if the current code follows modern Python (3.10+) idioms (e.g.,
- Act:
- Write Python code with complete Type Hints, prioritizing the
X | Ysyntax. - Prefer modern language features:
matchstatements (3.10+),TaskGroup(3.11+), and new generic syntax (3.12+). - Ensure code passes static analysis and unit tests.
- Write Python code with complete Type Hints, prioritizing the
Coding Standards
- Type Hinting: Strongly recommended for all function signatures. Use 3.10+ union syntax like
list[int | str]. - PEP 8 Compliance: Follow official style guidelines. Recommended to use
ruffas a linter and formatter for consistency. - Async Processing: Use 3.11+
asyncio.TaskGroupto manage concurrent tasks. - Error Handling: Use specific exception types and leverage 3.11+
ExceptionGroupandexcept*syntax.
Tooling Recommendations
- Linter / Formatter:
ruff(high performance and highly integrated). - Type Checker:
mypyorpyright. - Testing:
pytestwithpytest-asyncioorpytest-cov. - Package Management:
Poetryoruvto ensure dependency locking and environment consistency.
Deliver
- Code Quality Report: Identify parts that do not comply with 3.10+ modern syntax or PEP 8.
- Best Practice Recommendations: Provide specific refactoring suggestions, such as converting complex logic into
match/casestructures. - Validated Code: Provide Python source code accompanied by test cases and passed type checks.
Validate
- Code must run in a Python 3.10+ environment.
- Functions should have Docstrings (following Google or NumPy styles).
- Complex logic should include unit tests.
- All public APIs should have complete type hints.
Documentation
Official References
Internal References
- Modern Python syntax evolution (3.10-3.14) and PEP 8 naming conventions
- Recommended modern Python 3.10 - 3.14 development patterns and best practices
- Outdated Python practices to avoid, common pitfalls, and security traps
- Intelligent detection and management of Python project virtual environments and dependency tools