- 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 就会安装它。