- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill agents-python-tools -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill agents-python-tools -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill agents-python-tools -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add omagents/omagents --skill agents-python-tools -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/omagents/omagents/tree/HEAD/packages/core/skills/agents-python-tools來自發布者
Use a persistent base for agent tools and an isolated project overlay for project dependencies:
Install every Python tool the agent itself needs into the persistent base. Never install these into a project venv or system Python. Existing base environments are reused, never automatically deleted.
Create base only if its interpreter is missing:
python3 -m venv ~/.venvs/omagents
Check before installing, then use base Python explicitly:
~/.venvs/omagents/bin/python -c "import openpyxl; ..."
~/.venvs/omagents/bin/python -m pip install <package>
Use the absolute base interpreter or base console script so an active project venv cannot redirect the command. Do not install agent tools into a project venv, system Python, or pipx.
Create the project environment only when a project dependency is needed. An existing project .venv is left untouched.
The CLI is at <omagents-core>/hooks/project-venv.js. Resolve <omagents-core> through the active host's packaged Core resources; in a source checkout it is packages/core:
# Create or reuse the project environment and base overlay
node <omagents-core>/hooks/project-venv.js ensure --root <project-root>
# Install project-declared dependencies locally
node <omagents-core>/hooks/project-venv.js pip --root <project-root> -- install -r requirements.txt
node <omagents-core>/hooks/project-venv.js pip --root <project-root> -- install -e .
# Run with project packages first, then base tool packages
node <omagents-core>/hooks/project-venv.js run --root <project-root> -- script.py
Project dependencies declared in pyproject.toml, requirements.txt, or equivalent files must be installed locally even when base already contains the same package. Base is only a tool overlay, not a source of undeclared project dependencies.
Do not run pip directly in a project overlay. project-venv.js pip sets OMAGENTS_PROJECT_ONLY=1, which disables the base overlay so pip cannot mistake base packages for project-local installations. Normal run removes that variable and enables base imports.
The overlay shares Python imports, not console scripts. Invoke base tools from base bin/Scripts; project packages always override same-named base packages.
.omagents/venv via project-venv.js pip.Use <python> -m pip rather than a pip launcher. Node CLI commands work unchanged on all platforms; only direct interpreter paths differ.
~/.venvs/omagents/bin/python -m pip list.majorMinor must match, especially for native extensions.The plugin auto-installs jinja2 on first session (used by deep-research report templates). Other tools (markitdown, playwright, Office libraries, etc.) are installed on-demand by their respective skills when first needed. They are not eagerly pre-installed.
Route agent Python tooling to a dedicated venv at ~/.venvs/omagents, separate from any project's Python environment. Use whenever the agent needs to install or run a Python tool/library to complete a
---name: agents-python-toolsdescription: Route agent Python tooling to a dedicated venv at ~/.venvs/omagents, separate from any project's Python…---# packages/core/skills/agents-python-tools/SKILL.md總覽
Route agent Python tooling to a dedicated venv at ~/.venvs/omagents, separate from any project's Python environment. Use whenever the agent needs to install or run a Python tool/library to complete a task — e.g. openpyxl to generate Excel, pdf2md/pdfplumber to convert PDFs to Markdown, Pillow to generate images, qrcode, reportlab, or any pip-installable utility. Also use when deciding where a Python dependency belongs or when installing the current project's own dependencies into its OmAgents project overlay.
常見問題
從發布者下載 packages/core/skills/agents-python-tools/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/omagents/omagents。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。