← All articles

Do AI skills need Node.js or Python? Separate instructions from runtimes

You do not need to install both runtimes before trying an AI skill. Learn how SKILL.md, helper scripts and the agent differ, then check only the environment a particular skill actually needs.

AI Skill Market · Published · Updated

Before installing Node.js and Python for an AI skill, read its listing and README. You may need one, both, or neither. Installing both just in case adds work without telling you whether the skill will run.

Instructions, runtimes and agents have different jobs

SKILL.md tells an agent how to perform a task and what constraints to follow. A skill directory can also contain references, templates and helper scripts. The Agent Skills specification makes the scripts directory optional.

A runtime executes those helper scripts. If the README tells you to run a .js or .mjs helper with Node.js, you need a compatible Node.js runtime. A .py helper needs Python. The agent itself reads the instructions and calls available tools. An agent implemented in Node.js does not make every skill a Node.js program.

A quick reference

This table describes additional requirements from a skill. Check the agent application's own requirements separately.

Skill contents       | What to check
Instructions only    | May need neither Node.js nor Python
Python helper        | Specified Python and dependencies
Node.js helper       | Specified Node.js and dependencies
Helpers using both   | Both, only when explicitly required

The marketplace's Required runtimes field is a starting point. Read the actual SKILL.md and README for versions, packages, operating systems and optional features. A value of None does not mean the skill needs no tools of any kind.

For example, the Product Photo Campaign Kit lists no local runtime requirement. Its SKILL.md instead requires an available image-generation/editing tool. Being able to view an image is not enough. Manually providing its instructions in ChatGPT or another app is also different from automatic discovery of a skill directory.

AI Skill Safety Audit is a Python example. Its listing and actual SKILL.md specify Python 3.10 or later, using only the standard library. It can read Node.js source without Node.js because it does not execute the inspected code. That minimum belongs to this skill; it is neither a universal skill requirement nor a recommendation to install Python 3.10 itself. Choose a compatible version and check its official support status.

Check versions before changing anything

On Windows, use PowerShell or a terminal to run only the checks relevant to your skill. These commands do not install or upgrade software. npm is a Node.js package manager; whether you need it depends on the README.

node --version
npm --version
python --version

If py is available on Windows, you can also check it:

py --version

On a Mac, the Python command may be named python3:

python3 --version

For this article, we ran the node, npm, python and py version checks in an agent terminal on Windows. We also observed that python and py selected different versions. We reviewed the macOS documentation but did not test on a Mac. A successful version check is not a compatibility test for every skill.

Listing -> SKILL.md / README -> Identify the execution environment
        -> Check required runtime versions -> Review code and permissions
        -> Try a small, authorized input

When a command cannot be found

A missing command can mean the software is absent, or that its directory is missing from PATH, the list of folders searched for commands. An application that is already running may retain an older environment after settings change. Recheck in a new terminal or after restarting the agent before reinstalling anything.

Python on a server or in a container does not automatically become available on your Windows computer, and a local Windows installation does not automatically become available on a server. Run the checks where the agent will actually execute the helper. Virtual environments can also select different Python interpreters and packages. If the version check works but a module is missing, compare the README with the selected environment rather than adding packages at random.

Official downloads and ZIP boundaries

When a dependency really is needed, start with the official Node.js downloads or official Python downloads. We did not install or upgrade software for this article. Sellers should not bundle .exe files in marketplace ZIPs; document external dependencies and their official distribution pages instead. The upload restriction does not prohibit a user from obtaining a required runtime separately from its official source.

Review the publisher, code and requested permissions before enabling a skill. The free audit skill provides evidence for review, not a safety guarantee: no findings does not prove that a package is safe. Do not launch untrusted candidate code just to inspect it. For folder placement, use the Windows and Mac install guide.

Official references