- name
SKILL.md
O arquivo da skill permanece no repositório do publicador.
Cole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add omagents/omagents --skill agents-python-tools -a cursor -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add omagents/omagents --skill agents-python-tools -a claude-code -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add omagents/omagents --skill agents-python-tools -a codex -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add omagents/omagents --skill agents-python-tools -a grok -yEnvie a mensagem copiada em um chat do Grok Bot. O Bot busca este SKILL.md no GitHub e o adiciona às skills que todos os seus Bots compartilham.
Install this skill: https://github.com/omagents/omagents/tree/HEAD/packages/core/skills/agents-python-toolsDo publicador
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.mdVisão geral
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.
Perguntas frequentes
Baixe packages/core/skills/agents-python-tools/SKILL.md do publicador ou copie o caminho e abra o repositório. O PlugMCP lista a skill e não hospeda o arquivo.
O publicador o mantém em https://github.com/omagents/omagents.
Claude, Cursor, Codex e Grok Build conseguem ler um SKILL.md que você adiciona a partir do repositório do publicador. O Grok Bot o instala quando você envia em um chat o link da pasta da skill no GitHub.