Skip to content
Back to search

bambu-studio

SkillWorks with Claude CodeGitHub

Design, remix, slice and prepare 3D prints with Bambu Studio on macOS (Bambu Lab A1 mini by default). Use when the user wants to modify a model they liked, design a part from scratch, slice an STL/3MF, or print on their Bambu printer; Turkish triggers: "3D baskı", "bunu bas", "tasarla", "Bambu Studio".

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tumaysolak--bambu-studio-skill/badge.svg)](/listings/tumaysolak--bambu-studio-skill)

HTML

<a href="/listings/tumaysolak--bambu-studio-skill"><img src="/api/listings/tumaysolak--bambu-studio-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/tumaysolak/bambu-studio-skill ~/bambu-studio-skill
cd ~/bambu-studio-skill && ./setup.sh

Requirements: macOS, Bambu Studio in `/Applications`, Homebrew, `uv` (installed by setup if missing).

To use it as a Claude skill, copy `SKILL.md` into your skills folder (or upload it as a skill); it calls the scripts in `~/bambu-studio-skill`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 80 lines
  1. ---
  2. name: bambu-studio
  3. description: Design, remix, slice and prepare 3D prints with Bambu Studio on macOS (Bambu Lab A1 mini by default). Use when the user wants to modify a model they liked, design a part from scratch, slice an STL/3MF, or print on their Bambu printer; Turkish triggers: "3D baskı", "bunu bas", "tasarla", "Bambu Studio".
  4. ---
  5. # Bambu Studio: design, remix, slice, print
  6. Toolkit repo: https://github.com/tumaysolak/bambu-studio-skill (local clone: `~/bambu-studio-skill`).
  7. Full Turkish expert guide with every verified detail: `docs/Bambu-Studio-Uzman-Rehberi.md` (copy also on the Desktop). Read it when anything below is unclear.
  8. ## How to reach the Mac
  9. - Run Mac commands with the local macOS shell tool (e.g. `MacOS-MCP__Shell` / Desktop Commander), not the Linux sandbox. Keep long jobs under the tool timeout or run them with `nohup` and poll.
  10. - To look at images (previews), grant the session `~/bambu-studio-skill` as a folder, stage the PNG and Read it.
  11. - Use computer use only for the final GUI check and the send-to-printer dialog.
  12. ## First run check
  13. ```bash
  14. test -d ~/bambu-studio-skill || git clone https://github.com/tumaysolak/bambu-studio-skill ~/bambu-studio-skill
  15. cd ~/bambu-studio-skill && ./setup.sh # openscad@snapshot, uv venv (trimesh, manifold3d, build123d), sanity slice
  16. ```
  17. Paths: `B=/Applications/BambuStudio.app/Contents/MacOS/BambuStudio`, `PY=~/bambu-studio-skill/.venv/bin/python`, scripts in `~/bambu-studio-skill/scripts`.
  18. ## Pipeline
  19. 1. **Understand the request in millimetres.** Size, what it holds/fits, material, colors, strength. Ask only for a missing critical dimension; otherwise pick sensible defaults and state them.
  20. 2. **Get geometry**
  21. - From scratch: write parametric OpenSCAD (`openscad --backend=manifold -o out.stl file.scad`), start from `templates/` when one fits (`name_tag.scad` two-color tag, `box_lid.scad` slip-fit box, `phone_stand.scad`). Use build123d for fillets/STEP-grade mechanical parts.
  22. - Remix: convert to STL and edit with `$PY scripts/mesh_tools.py` (`info`, `scale --fit/--factor`, `rotate`, `flat`, `cut --z`, `hole --at --d`, `text|textpart`, `boolean`, `repair`, `convert`).
  23. 3. **Verify geometry**: `mesh_tools.py info` (fits 180x180x180, watertight) and `mesh_tools.py preview x.stl x.png`, then look at the PNG. Fix before slicing.
  24. Then **always** run `$PY scripts/mesh_tools.py firstlayer model.(stl|3mf)` (also for downloaded 3MFs you only re-slice) and apply every ADVICE line (brim/raft, slow first layer, fan/plate `--fset`, tree support); checklist item 4 has the rules.
  25. 4. **Slice**: `python3 scripts/bambu_slice.py model.stl [--process ...] [--set key=value ...] --out <path>.gcode.3mf --open`
  26. - Multi-color single design: export each color as its own STL in the same coordinates, then `--assemble --filament F --filament F --color #FFFFFF --color #C12E1F --filament-ids 1,2`.
  27. - Presets: `python3 scripts/bambu_profiles.py list process --filter A1M` / `list filament --filter A1M`.
  28. 5. **Report** to the user: dimensions, material, print time, grams, layers, any warnings, and the 3MF path. The 3MF is already open in Bambu Studio via AppleScript.
  29. 6. **Print only on explicit approval, and before EVERY send ask the user: "Tablayı sildin mi?"** (dish soap or IPA, dry, no fingers on the surface). Send only after they confirm; a "bas"/"gönder" alone is not that confirmation. Then: In the GUI: Hazırla tab → "Baskı tablasını dilimle" → "Baskı tablasını yazdır" → check printer, AMS slot mapping (match colors to loaded spools in the Cihaz tab), bed leveling → "Gönder". Screenshot each step. If the Cihaz tab shows a print in progress, do not send and never touch pause/stop.
  30. 7. **After sending**: tell the user to watch the first 3 layers. The A1 mini does NOT detect a lifted/curled tip (it only senses flow and collisions), so "machine found no problem" means nothing for adhesion.
  31. ## Pre-print checklist (from a real failed leaf tip, Nov 2026)
  32. 1. **Which design is "open"?** Several BambuStudio processes may run. Read `recent_projects` in `~/Library/Application Support/BambuStudio/BambuStudio.conf` and the file's mtime, then confirm with a screenshot. The window title can belong to an older instance.
  33. 2. **Read the designer's 3MF settings** (`Metadata/project_settings.config`, `slice_info.config` for their grams/time) before changing anything; keep their layer height and orientation unless there is a reason.
  34. 3. **Strength** for functional parts (door stopper, hook, bracket): `wall_loops=4`, `sparse_infill_density=25%`, `sparse_infill_pattern=gyroid`, `top_shell_layers=6`, `bottom_shell_layers=5`. Usually only +10-20 % grams; report designer vs new grams/time in a table.
  35. 4. **Adhesion and support are mandatory decisions, never left on auto.** Two real failures: a leaf tip curled (thin tip) and a 173 mm ball holder lifted at a corner and was stopped (large footprint, designer had no raft/support). Before every print, from the `firstlayer` output:
  36. - thin tips → `brim_type=outer_only` (`auto_brim` often prints NO brim for PLA on Textured PEI);
  37. - footprint span >120 mm or contact >3000 mm² → `raft_layers=3` (or `brim_type=outer_only`, `brim_width=8` when raft marks matter) and leave ≥8 mm free around the part (scale down a few % if needed);
  38. - always with either of the above: `initial_layer_speed=30`, `initial_layer_infill_speed=50`, and filament overrides `--fset close_fan_the_first_x_layers=3 --fset textured_plate_temp_initial_layer=70` (PLA on Textured PEI: fan off for the first 3 layers, plate +5 °C on the first layer only; verified in G-code: `M190 S70` then `M140 S65`). PETG: plate +5 °C over its preset, fan off 3 layers;
  39. - overhang >50 mm² → `enable_support=1`, `support_type=tree(auto)`, `support_on_build_plate_only=1`; skip only if the designer printed it support-free and the overhang is a low lip;
  40. - functional parts near the bed limits: prefer raft + support over saving 10 minutes.
  41. Tell the user to watch the first layers and corners.
  42. 5. **GUI did not keep all CLI `--set` values** (support, raft and first-layer speeds included) when the re-sliced 3MF was reopened (wall_loops, bottom shells, infill density/pattern fell back). After opening, check the Dayanıklılık tab, fix fields by hand, re-slice in the GUI and compare its grams with the CLI result. Save (cmd+S).
  43. 6. **Send dialog**: confirm the AMS slot the user named (e.g. A3 = green), keep bed leveling on, turn timelapse OFF if the "surface defects" warning appears (unless the user wants a timelapse).
  44. 7. **Computer use**: resolve the app as "BambuStudio" (not "Bambu Studio"). Another app's window (e.g. Word) can sit on top and block a click; take a fresh screenshot and retry.
  45. ## Hard-won rules (do not relearn these)
  46. - System presets use `inherits`/`include`; always pass flattened JSON (`bambu_profiles.py flatten`, done inside `bambu_slice.py`).
  47. - `--export-3mf` takes a file NAME; `--outputdir` must be absolute.
  48. - CLI-written 3MFs break the GUI (unescaped quotes in `model_settings.config`). `bambu_slice.py` repairs automatically; for other 3MFs run `scripts/fix_3mf.py file.3mf --model-id N1`.
  49. - Never empty `compatible_printers` (CLI then refuses: exit 239).
  50. - Multi-color needs `filament_map`/`filament_nozzle_map`/`filament_volume_map` sized to the filament count and `filament_colour` in each filament JSON, or extra colors are silently dropped (handled by `bambu_slice.py`).
  51. - `--arrange 0` with origin-centred meshes = object off the 0..180 bed (exit 206).
  52. - Open files in the running app with `osascript -e 'tell application id "com.bambulab.bambu-studio" to open POSIX file "/abs/path"'`; `open -a` spawns extra instances.
  53. - Keep `--orient 0` when you designed the print orientation yourself.
  54. - GUI paths: support = Destek tab ("Desteği etkinleştir", "Sadece baskı tablasında", "Raft katmanları"); first-layer speed = Hız tab ("İlk katman", "İlk katman dolgusu"); fan and plate temperature are FILAMENT settings, so set them with `--fset` in the CLI slice (the GUI may drop them on reopen: check the plate temperature shown in the send dialog/G-code); use the search box (magnifier) instead of scrolling. Raft expansion is not exposed in the GUI. The gear icon next to "Proje Filamentleri" opens the filament PICKER, not filament settings; cancel it.
  55. - Reopened CLI-sliced 3MFs can show preset values instead of your `--set` overrides in the GUI; verify in the GUI before printing (checklist item 5).
  56. ## A1 mini design rules (0.4 nozzle)
  57. Walls ≥0.8 mm (1.6 for strong parts) · overhangs ≤45° without support · bridges ≤25 mm · vertical holes +0.2 mm (M3 → 3.2) · fits: 0.1 press, 0.2 slide, 0.3-0.4 loose · raised text ≥5 mm tall, 0.6-1.2 mm high · first-layer features narrower than 5 mm (leaf tips, spikes) need a brim · footprint >120 mm needs a raft or 8 mm brim plus 30 mm/s first layer · largest flat face down · split parts >180 mm with `cut` and add pin holes · open frame: PLA/PETG/TPU yes, ABS/ASA no · color changes cost ~30 s each plus a prime tower.
  58. Defaults (`0.20mm Standard @BBL A1M`): wall_loops 2, sparse_infill_density 15%, grid, top/bottom 5/3, support off, tree(auto) when enabled, brim None, Textured PEI Plate. Useful overrides: `wall_loops=3`, `sparse_infill_density=25%`, `sparse_infill_pattern=gyroid`, `enable_support=1`, `support_on_build_plate_only=1`, `brim_type=outer_only`, `ironing_type=top`, `spiral_mode=1`, `elefant_foot_compensation=0.15`, `xy_hole_compensation=0.1`, `curr_bed_type="Cool Plate"` (via `--plate`).
  59. ## Safety
  60. - Sending, pausing, stopping a print or starting calibration needs the user's explicit go-ahead each time.
  61. - Never write the printer access code, serial or account data into files, logs shown to the user, or the repo.
  62. - Respect model licenses; credit the original designer when publishing a remix.
README.md · README · 82 lines
  1. # bambu-studio-skill
  2. An agent skill (Claude / any coding agent with a macOS shell) that turns a plain-language request into a print-ready Bambu Studio project:
  3. - **Design from scratch** with parametric OpenSCAD or build123d
  4. - **Remix models you like** (scale, cut, holes, embossed/debossed text, booleans, repair)
  5. - **Slice headlessly** with the Bambu Studio CLI using the real system presets (A1 mini by default, any Bambu printer works)
  6. - **Multi-color** (AMS / AMS lite) parts from separate STLs
  7. - **Open the result in the running Bambu Studio** for a final check and send-to-printer
  8. Everything was verified on macOS with Bambu Studio 02.09.01.70 and a Bambu Lab A1 mini.
  9. ## Why this exists
  10. The Bambu Studio CLI works, but several undocumented behaviours make naive automation fail:
  11. | Problem | Fix in this repo |
  12. |---|---|
  13. | System presets use `inherits`/`include` chains; the CLI wants complete JSON | `scripts/bambu_profiles.py flatten` |
  14. | CLI-written 3MFs fail to open in the GUI (unescaped quotes in `Metadata/model_settings.config`) | `scripts/fix_3mf.py` (auto-applied by `bambu_slice.py`) |
  15. | Emptying `compatible_printers` makes the CLI reject the process (exit 239) | keep the list, repair the 3MF afterwards |
  16. | Extra filaments are silently dropped in multi-color slices | `bambu_slice.py` fills `filament_map`, `filament_nozzle_map`, `filament_volume_map`, `filament_colour` |
  17. | `--export-3mf` with a path writes to `outputdir//abs/path` (exit 243) | pass a file name, absolute `--outputdir` |
  18. | `open -a BambuStudio file` starts a new instance every time | AppleScript `open POSIX file` into the running app |
  19. ## Install
  20. ```bash
  21. git clone https://github.com/tumaysolak/bambu-studio-skill ~/bambu-studio-skill
  22. cd ~/bambu-studio-skill && ./setup.sh
  23. ```
  24. Requirements: macOS, Bambu Studio in `/Applications`, Homebrew, `uv` (installed by setup if missing).
  25. To use it as a Claude skill, copy `SKILL.md` into your skills folder (or upload it as a skill); it calls the scripts in `~/bambu-studio-skill`.
  26. ## Quick start
  27. ```bash
  28. cd ~/bambu-studio-skill
  29. # slice an STL for an A1 mini (0.20mm Standard, Bambu PLA Basic) and open it in Bambu Studio
  30. python3 scripts/bambu_slice.py ~/Downloads/model.stl --open
  31. # two-color name tag from a template
  32. openscad --backend=manifold -D 'name="HELLO"' -D 'part="base"' -o /tmp/base.stl templates/name_tag.scad
  33. openscad --backend=manifold -D 'name="HELLO"' -D 'part="text"' -o /tmp/text.stl templates/name_tag.scad
  34. python3 scripts/bambu_slice.py /tmp/base.stl /tmp/text.stl --assemble \
  35. --filament "Bambu PLA Basic @BBL A1M" --filament "Bambu PLA Basic @BBL A1M" \
  36. --color "#FFFFFF" --color "#C12E1F" --filament-ids 1,2 --out ~/Desktop/tag.gcode.3mf --open
  37. # remix: fit a downloaded model to 150 mm and add a 5.2 mm hole
  38. .venv/bin/python scripts/mesh_tools.py scale model.stl big.stl --fit 150
  39. .venv/bin/python scripts/mesh_tools.py hole big.stl final.stl --at 0,0 --d 5.2
  40. ```
  41. Other printers: `--printer "Bambu Lab P1S 0.4 nozzle" --process "0.20mm Standard @BBL P1S" --filament "Bambu PLA Basic @BBL P1S"` (list names with `scripts/bambu_profiles.py list`).
  42. ## Layout
  43. ```
  44. SKILL.md agent instructions
  45. docs/Bambu-Studio-Uzman-Rehberi.md full expert guide (Turkish)
  46. scripts/bambu_slice.py model(s) -> sliced, GUI-safe .gcode.3mf + JSON report
  47. scripts/bambu_profiles.py list / show / flatten Bambu Studio presets
  48. scripts/fix_3mf.py repair CLI-written 3MF for the GUI
  49. scripts/mesh_tools.py remix toolkit (trimesh + manifold3d, OpenSCAD for text/preview)
  50. + `firstlayer`: pre-print adhesion check (thin tips -> brim advice)
  51. templates/*.scad verified parametric starting points
  52. setup.sh dependencies + sanity slice
  53. ```
  54. ## Safety
  55. The skill never sends, pauses or stops a print without explicit user approval, and never stores printer access codes or account data.
  56. ## Türkçe özet
  57. Bambu Studio'yu Mac üzerinden otomatik kullanan açık kaynak bir skill: beğendiğin modeli değiştirir, sıfırdan parametrik tasarım yapar, A1 mini için dilimler ve sonucu Bambu Studio'da açar. Ayrıntılı rehber: `docs/Bambu-Studio-Uzman-Rehberi.md`.
  58. ## License
  59. MIT. Contact: [linkedin.com/in/tumaysolak](https://linkedin.com/in/tumaysolak)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.