Guide · Agent skill
How to use the 3MF Hole Resizer and Mesh Repair agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The cli-anything-3mf skill lets an AI agent work with 3MF print files, the 3D model format used by slicers such as BambuStudio and PrusaSlicer. After installing it, you can ask the agent to report a model's geometry, find cylindrical holes, resize chosen holes to a target diameter, repair common mesh errors and compare two files. This guide is for 3D printing hobbyists, makers and engineers who want that help without learning the command line themselves.
3MF Hole Resizer and Mesh RepairHKUDS/CLI-Anything · Apache-2.0 Download the skill Quick start
- 1Install Python and pip. Confirm Python with pip is available on your computer before installing the skill.
- 2Install the command-line tool. Run the pip install command from GitHub to add cli-anything-3mf to your system.
- 3Add the skill folder. Download the ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills.
- 4Ask for an inspection. Ask the agent to inspect your 3MF file so it reports cylindrical holes and their diameters.
- 5Resize chosen holes. Name the hole numbers and target diameter, and have the agent write the result to a new output file.
- 6Check the result. Run info or compare on the output and test print the part before replacing the original.
What an agent skill is and what this one does
An agent skill is a folder containing a SKILL.md file that describes a task and the commands an AI agent can run to do it. This skill is for 3MF mesh geometry editing. Its SKILL.md says it teaches the agent to call a command-line tool named cli-anything-3mf instead of guessing from file contents.
- Report mesh info: vertices, faces, bounding box, watertight status and volume (info command).
- Detect cylindrical holes with their center, diameter and confidence (inspect command).
- Resize chosen holes to a target diameter and write a new file (resize command).
- Fix degenerate faces, duplicate vertices and normals (repair command).
- Compare two 3MF files (compare command).
Install the cli-anything-3mf skill
You need Python with pip. The skill's tool installs from GitHub, so you can also install the command-line tool directly with the command below. The source lists the skill file as SKILL.md, and you can get the skill itself as a ZIP from the download on this page.
To add the skill as a file, download the ZIP from this page and unzip it into ~/.claude/skills/ for all your projects, or into a project's .claude/skills/ folder for one project only. Alternatively, upload it in the Claude apps under Settings → Capabilities → Skills.
- Requires Python with pip.
- Personal install: unzip into ~/.claude/skills/.
- Project install: unzip into .claude/skills/ inside your project.
- Claude apps: Settings → Capabilities → Skills, then upload.
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=3MF/agent-harnessTrigger the skill with natural requests
You do not need to type the command name yourself. Describe what you want in plain language and mention your file, such as model.3mf. The agent should pick the matching command. If you want machine-readable results, the source says every command supports --json, for example when you ask the agent to inspect a file and return JSON.
Give the agent the file path and what you want changed. For resizing, name the hole numbers from the inspect output and the target diameter in millimetres if you know it.
- "Check whether model.3mf is watertight and show its volume."
- "Find the cylindrical holes in bracket.3mf and list their diameters."
- "Resize holes 0 and 1 in bracket.3mf to 4.2 mm and save as bracket_fixed.3mf."
- "Repair mesh.3mf and write the result to repaired.3mf."
- "Compare v1.3mf and v2.3mf and tell me what changed."
Run the commands yourself
If you prefer to run the tool directly, these are the commands listed in the skill. The resize command writes a new file to the path given with -o, so the original is left in place. Check the output before you replace anything.
- info shows mesh details; inspect detects holes; resize sets target diameter; repair fixes mesh issues; compare checks two files.
cli-anything-3mf info <file.3mf>
cli-anything-3mf inspect <file.3mf>
cli-anything-3mf resize <file.3mf> --hole 0 --hole 1 --diameter 4.2 -o output.3mf
cli-anything-3mf repair <file.3mf> -o repaired.3mf
cli-anything-3mf compare <file1.3mf> <file2.3mf>Safety notes: scripts and network
This skill runs scripts, so treat it like any other code you install. The source marks it as running scripts and not using the network. Only install it from a source you trust, and review SKILL.md first.
Resizing changes geometry, so a hole may not fit the part it was meant for until you test print it. Keep a backup of the original 3MF file before any change.
- Runs scripts: yes. Uses network: no, per the listing.
- Keep your original files backed up.
- Check the output file before replacing the original.
- Test print any resized hole before relying on it.
Tips for better results
Run inspect before resize so you know which hole numbers to target. Run info before and after repair to see whether the watertight status changed. The skill works with any 3MF file that conforms to the 3MF Core Specification, but the source specifically names BambuStudio and PrusaSlicer files, and slicer metadata is preserved on repack.
- Run inspect first to get hole numbers.
- Use info before and after repair to check watertight status.
- Use compare to see differences between revisions.
- Keep the -o output separate from the original file name.
What people use it for
- Make a peg or bolt hole fit a specific size for a printed part.
- Check whether a model is watertight before sending it to print.
- Compare two revisions of an engineering 3MF print file.
- Repair degenerate faces and duplicate vertices in a downloaded model.
Frequently asked questions
How do I install the cli-anything-3mf skill?
Install Python with pip, run the pip install command from the GitHub repository, then download the skill ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. You can also upload it in the Claude apps under Settings → Capabilities → Skills.
What do I need to use this skill?
You need Python with pip and local 3MF files to process. The skill runs scripts, and the listing says it does not use the network.
Is the 3MF hole resizer free to use?
The item is listed under the Apache-2.0 licence. Check the licence file in the repository for the full terms before you use or redistribute it.
Which slicer files does it work with?
The description says it works with BambuStudio and PrusaSlicer 3MF files. The source also says it works with any 3MF file that conforms to the 3MF Core Specification.
Can it fix a model that is not watertight?
The repair command fixes degenerate faces, duplicate vertices and normals. The listing warns that non-watertight or heavily damaged meshes may not produce a printable result, so check the output carefully.
Will resizing a hole make my part fit?
Not guaranteed. Resizing changes geometry and may misfit parts, so test print the resized hole before relying on it. Always keep your original file.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits 3D printing hobbyists who need a hole to fit a specific size, makers checking whether a model is watertight, and engineers comparing 3MF revisions. Pick something else if you need exact tolerances without a test print, if your meshes are heavily damaged, or if you cannot keep backups of your original files.
Download the skill