Agent skill

Fix Module Not Found Error

by Nuitka in Nuitka/Nuitka

Diagnose and fix ModuleNotFoundError in Nuitka standalone binaries caused by missing implicit imports.

AGPL-3.0Auto-check passedData & Analytics

Install Fix Module Not Found Error

skills CLI
$ npx skills add Nuitka/Nuitka --skill fix-module-not-found-error -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Nuitka/Nuitka fix-module-not-found-error --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Nuitka/Nuitka.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/fix-module-not-found-error .claude/skills/fix-module-not-found-error && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fix-module-not-found-error
GitHub stars
15k
Token cost
~519 tokens
SKILL.md length
211 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Diagnose and fix ModuleNotFoundError in Nuitka standalone binaries caused by missing implicit imports.

  • Works in 3 steps: Reproduction and Analysis → Locate Configuration → Implement the Fix
  • A compiled program fails at runtime because an imported module was not included
  • SKILL.md covers 1. Reproduction and Analysis, 2. Locate Configuration and 3. Implement the Fix
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Fix Module Not Found Error is an agent skill from Nuitka/Nuitka. Diagnose and fix ModuleNotFoundError in Nuitka standalone binaries caused by missing implicit imports. Use when a compiled program fails at runtime because an imported module was not included.

Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Data & Analytics. It works with pandas and Python. The repository describes itself as: Nuitka is a Python compiler written in Python. It's fully compatible with Python 2.6, 2.7, 3.4-3.14. You feed it your Python app, it does a lot of clever things, and spits out an… The licence is AGPL-3.0.

When your agent uses it

  • A compiled program fails at runtime because an imported module was not included

Example prompts

  • “/fix-module-not-found-error”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Reproduction and Analysis
  2. Locate Configuration
  3. Implement the Fix

What it can do on your machine

Read from SKILL.md and the folder at commit c050c94. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fix Module Not Found Error loads about 519 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 211 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~519

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Nuitka/Nuitka at commit c050c94, republished under its AGPL-3.0 licence (© Nuitka). 211 words, ~519 tokens.

Download SKILL.mdSave it as .claude/skills/fix-module-not-found-error/SKILL.md (or your agent's skills folder).
name
fix-module-not-found-error
description
Diagnose and fix `ModuleNotFoundError` in Nuitka standalone binaries caused by missing implicit imports. Use when a compiled program fails at runtime because an imported module was not included.

How to fix ModuleNotFoundError in Nuitka

This workflow guides you through resolving ModuleNotFoundError when running a Nuitka-compiled binary, specifically caused by missing implicit dependencies (e.g., hidden imports in Cython modules).

1. Reproduction and Analysis

  1. Isolate the error: Create a minimal reproduction script (MRE) that triggers the ModuleNotFoundError. Follow .agents/skills/create-mre/SKILL.md for the reduction workflow.
  2. Verify the crash: Run the MRE with Nuitka in standalone mode to confirm the error persists.
  3. Analyze the traceback:
    • Identify the missing module name (e.g., pandas._libs._cyutility).
    • Identify the importer module (e.g., pandas._libs.tslibs.ccalendar).
    • Note: If the importer is a compiled extension (e.g., .pyx, .so, .pyd), Nuitka cannot automatically detect imports inside it.

2. Locate Configuration

  1. Find the configuration file: Most package-specific configurations are in nuitka/plugins/standard/standard.nuitka-package.config.yml.
  2. Search for the package: Look for the top-level package (e.g., pandas) or the specific submodule in the YAML file.

3. Implement the Fix

  1. Add Implicit Import:

    • If the importer module already has an entry, add the missing module to its implicit-imports -> depends list.
    • If the importer module is missing, create a new entry for it.
    yaml
    - module-name: 'importer.module.name'
      implicit-imports:
        depends:
          - 'missing.module.name'
  2. Verify the fix: Re-run the MRE compilation.

    • Ensure the Nuitka-Plugins:implicit-imports log shows the dependency being added (if verbose logging is enabled).
    • Run the compiled binary and confirm it executes without the ModuleNotFoundError.

© Nuitka, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/fix-module-not-found-error of Nuitka/Nuitka.

Open the folder on GitHubat commit c050c94

Compare with similar skills

Fix Module Not Found Error next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fix Module Not Found Error compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fix Module Not Found Error this skillNuitka/Nuitka15k—~519Automated safety check: PassAGPL-3.0
Chdb Datastorevemetric/vemetric3942 repos~1.4kAutomated safety check: PassApache-2.0
CSV Data Summarizercoffeefuelbump/csv-data-summarizer-claude-skill4682 repos~1.4kAutomated safety check: PassNone
Senior Data ScientistRaidriar7170/hermes-skilleval1256 repos~1.4kAutomated safety check: PassMIT
Python Executorcortega26/chile-hub1132 repos~1.5kAutomated safety check: PassMIT
Retentioneering Product Analyticsretentioneering/retentioneering-tools920—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Chdb Datastore

    vemetric/vemetric

    A skill your agent uses when the user has tabular data (pandas DataFrame, parquet, csv, Arrow, json) and wants to filter, group, aggregate, join, or speed up slow pandas.

    394 GitHub starsUsed in 2 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • CSV Data Summarizer

    coffeefuelbump/csv-data-summarizer-claude-skill

    Analyzes CSV files, generates summary stats, and plots quick visualizations using Python and pandas.

    468 GitHub starsUsed in 2 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • Senior Data Scientist

    Raidriar7170/hermes-skilleval

    World-class data science skill for statistical modeling, experimentation, causal inference, and advanced analytics.

    125 GitHub starsUsed in 6 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • Python Executor

    cortega26/chile-hub

    Execute Python code in a safe sandboxed environment via [inference.sh](https://inference.sh).

    113 GitHub starsUsed in 2 repos~1.5k tokens
    Data & AnalyticsAuto-check passed
  • Retentioneering Product Analytics

    retentioneering/retentioneering-tools

    Analyze event logs, clickstreams, user paths, product funnels, retention, behavioral segments, transition graphs, step matrices, sequence patterns, and customer journeys using Retentioneering.

    920 GitHub stars~1.6k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Pandas Pro

    Jeffallan/claude-skills

    Handles pandas DataFrame work: cleaning, merging, groupby aggregation, pivots, time-series resampling and memory tuning, with checks on dtypes, shapes and nulls.

    12k GitHub starsUsed in 1 repo~1.5k tokens
    Data & AnalyticsAuto-check passed

More from Nuitka/Nuitka

  • Reproduce macOS Nuitka issues across Python distributions and GitHub Actions Python packaging.

    15k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Setup PR Branch

    Nuitka/Nuitka

    Set up a local branch that tracks a fork PR and can be pushed back to it, without fetching the whole fork.

    15k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Create a Nuitka planning document under .planning/ from the standard template.

    15k GitHub stars~468 tokensUpdated yesterday
    Auto-check passed
  • Create Mre

    Nuitka/Nuitka

    Create or reduce a Minimally Reproducible Example (MRE) for a Nuitka bug from a larger reproducer.

    15k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Obs Build Logs

    Nuitka/Nuitka

    Access and diagnose openSUSE Build Service (OBS) package build logs.

    15k GitHub stars~849 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Fix Module Not Found Error

What does Fix Module Not Found Error do?

Diagnose and fix ModuleNotFoundError in Nuitka standalone binaries caused by missing implicit imports. Fix Module Not Found Error is an agent skill from Nuitka/Nuitka. Diagnose and fix ModuleNotFoundError in Nuitka standalone binaries caused by missing implicit imports.

When should I use Fix Module Not Found Error?

Fix Module Not Found Error fits situations like: A compiled program fails at runtime because an imported module was not included.

How do I install Fix Module Not Found Error in Claude Code?

Run `npx skills add Nuitka/Nuitka --skill fix-module-not-found-error -a claude-code`. Or copy the skill folder (.agents/skills/fix-module-not-found-error in Nuitka/Nuitka) into .claude/skills/fix-module-not-found-error in your project. Claude Code loads it when a task matches its description.

How do I install Fix Module Not Found Error in Codex?

Run `npx skills add Nuitka/Nuitka --skill fix-module-not-found-error -a codex`. Or copy the skill folder (.agents/skills/fix-module-not-found-error in Nuitka/Nuitka) into .agents/skills/fix-module-not-found-error in your project. Codex loads it when a task matches its description.

Can I use Fix Module Not Found Error in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Nuitka/Nuitka --skill fix-module-not-found-error -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fix-module-not-found-error, .gemini/skills/fix-module-not-found-error, .github/skills/fix-module-not-found-error and .opencode/skills/fix-module-not-found-error in your project.

What does Fix Module Not Found Error need to run?

SKILL.md names no scripts, command-line tools or credentials: Fix Module Not Found Error is instructions for the agent only.

Does Fix Module Not Found Error access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fix Module Not Found Error safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fix Module Not Found Error use?

Fix Module Not Found Error is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fix Module Not Found Error use?

About 519 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fix Module Not Found Error?

Skills that share tags, products or a category with Fix Module Not Found Error: Chdb Datastore (vemetric/vemetric, 394 stars), CSV Data Summarizer (coffeefuelbump/csv-data-summarizer-claude-skill, 468 stars), Senior Data Scientist (Raidriar7170/hermes-skilleval, 125 stars) and Python Executor (cortega26/chile-hub, 113 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fix Module Not Found Error?

Nuitka (a GitHub organization) maintains it in Nuitka/Nuitka, which has 15,180 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 2026.

Source: Nuitka/Nuitka on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.