[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73CSNJG7XH3NERJKP28811S":3,"skill-same:01M73CSNJG7XH3NERJKP28811S":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":40,"repositoryHtmlUrl":41,"repositoryHomepageUrl":6,"ownerHtmlUrl":42,"ownerBlogUrl":43,"ownerDescription":6,"updatedAt":44,"install":45,"resources":58},"01M73CSNJG7XH3NERJKP28811S","troubleshoot-print-issues",null,"Diagnose and fix common 3D printing failures through systematic symptom analysis. Covers adhesion, stringing, layer shifts, warping, and under\u002Fover-extrusion issues. Use when a print fails during the first layer or partway through, finished prints have quality defects (stringing, blobs, gaps), dimensional accuracy issues occur (warping, elephant foot), layer adhesion fails, or new material or hardware changes are causing inconsistent results.","roohe\u002Fagentic-super-skills","roohe","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99054084?v=4","01M734WCDFP6RZVT5CNM00QR26","01M734WCE4BD0T4NZS5PCV9V5F",10,"MIT","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Ftroubleshoot-print-issues\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: troubleshoot-print-issues\nlocale: caveman-lite\nsource_locale: en\nsource_commit: 82c77053\ntranslator: \"Julius Brussee homage — caveman\"\ntranslation_date: \"2026-05-03\"\ndescription: >\n  Diagnose and fix common 3D printing failures through systematic symptom\n  analysis. Covers adhesion, stringing, layer shifts, warping, and\n  under\u002Fover-extrusion issues. Use when a print fails during the first layer\n  or partway through, finished prints have quality defects (stringing, blobs,\n  gaps), dimensional accuracy issues occur (warping, elephant foot), layer\n  adhesion fails, or new material or hardware changes are causing inconsistent\n  results.\nlicense: MIT\nallowed-tools: Read Write Edit Bash Grep Glob WebFetch\nmetadata:\n  author: Philipp Thoss\n  version: \"1.0\"\n  domain: 3d-printing\n  complexity: intermediate\n  language: multi\n  tags: 3d-printing, troubleshooting, fdm, sla, print-quality, failures\n---\n\n# Troubleshoot Print Issues\n\nDiagnose and fix common 3D printing failures using systematic symptom analysis. This skill covers the most frequent FDM and SLA issues: poor bed adhesion, stringing, layer shifts, warping, under-extrusion, over-extrusion, and print quality defects. Uses a structured approach of symptom identification, root cause analysis, and iterative fixes.\n\n## When to Use\n\n- Print fails during first layer or partway through\n- Finished prints have quality defects (stringing, blobs, gaps, rough surfaces)\n- Dimensional accuracy problems (over\u002Fundersized, warping, elephant foot)\n- Layer adhesion issues (delamination, splitting)\n- Support removal leaves damage or supports fail during print\n- Prints look different from slicer preview\n- Material behaves inconsistently across prints\n- New material, printer, or environmental conditions causing issues\n\n## Inputs\n\n- **failure_description**: What went wrong (failed first layer, stringing, warping, etc.)\n- **failure_timing**: When issue occurs (first layer, midprint, specific height, top layers)\n- **material**: Filament\u002Fresin type, brand, age, storage conditions\n- **printer**: Make\u002Fmodel, nozzle size, bed type, enclosure\n- **recent_changes**: New material, slicer settings, hardware modifications, environment\n- **print_history**: Does this model usually work? Did this material work before?\n\n## Procedure\n\n### 1. Collect Failure Symptoms\n\nDocument observable symptoms with specificity:\n\n**Visual inspection**:\n- Take photos of failure (overall, close-up, specific defect)\n- Note failure location (first layer, specific height, top surface)\n- Describe defect type: gaps, blobs, strings, shifts, cracks\n\n**Environmental data**:\n- Ambient temperature during print\n- Humidity level\n- Drafts or AC affecting printer\n- Time of day (temperature changes)\n\n**Print parameters**:\n```bash\n# Extract from G-code metadata\ngrep \"^;MAXX\\|^;MINX\\|^;MAXZ\" failed_print.gcode  # Print dimensions\ngrep \"^;PRINT_TIME:\" failed_print.gcode  # Estimated time\ngrep \"^M104\\|^M140\" failed_print.gcode | head -5  # Temperatures\ngrep \"^;generated by\" failed_print.gcode  # Slicer version\n```\n\n**Got:** Detailed symptom description with photos, parameters, and environmental context.\n\n**If fail:** If symptoms unclear, print a calibration test (temperature tower, stringing test, or benchy) to reproduce and observe failure systematically.\n\n### 2. Classify Issue by Symptom Pattern\n\nMatch observed symptoms to common failure modes:\n\n## Diagnostic Reference Table\n\n| Symptom | Likely Causes | Quick Check | Priority Fix |\n|---------|--------------|-------------|--------------|\n| **Poor bed adhesion** | Dirty bed, wrong temp, too high Z | Wipe bed, level bed | Clean bed, adjust Z-offset down 0.05mm |\n| **Stringing** | Too hot, insufficient retraction | Check nozzle temp | Lower temp 5°C, increase retraction +0.5mm |\n| **Layer shifts** | Loose belts, too fast, collision | Check belt tension | Tighten belts, reduce speed 20% |\n| **Warping** | Poor adhesion, fast cooling | Check corners lifting | Add brim, enclose printer, increase bed temp |\n| **Under-extrusion** | Clog, low temp, wrong flow | Check extrusion consistency | Clean nozzle, increase temp 5°C, calibrate e-steps |\n| **Over-extrusion** | High flow rate, wrong e-steps | Check blob formation | Reduce flow 2-5%, calibrate e-steps |\n| **Elephant foot** | First layer squish, bed too hot | Measure base width | Raise Z-offset +0.05mm, lower bed temp 5°C |\n| **Gaps in walls** | Thin walls, under-extrusion | Check wall thickness | Enable thin wall detection, increase flow |\n| **Layer delamination** | Low temp, poor cooling, contamination | Check layer lines | Increase temp 5-10°C, check wet filament |\n| **Blobs\u002Fzits** | Retraction, coast settings | Check seam alignment | Tune retraction, enable coasting |\n| **Rough top surface** | Insufficient top layers, ironing | Count solid top layers | Add 2 top layers, enable ironing |\n| **Sagging overhangs** | Insufficient cooling, too hot | Check part cooling fan | Increase cooling, lower temp, add supports |\n\n**Got:** Failure classified into 1-3 most likely categories.\n\n**If fail:** If symptoms match multiple categories, prioritize based on failure timing (first layer issues first, then midprint, then top surface).\n\n### 3. Perform Root Cause Analysis\n\nInvestigate underlying cause, not just symptoms:\n\n**5 Whys technique**:\n```\nSymptom: Print warping and lifting from bed\nWhy? → Poor bed adhesion in corners\nWhy? → Corners cooling faster than center\nWhy? → Room draft from AC vent\nWhy? → No enclosure to maintain stable temperature\nWhy? → ABS requires heated chamber for uniform cooling\n\nRoot cause: Material choice (ABS) incompatible with open printer in drafty room\n```\n\n**Common root causes by category**:\n\n**Mechanical**:\n- Loose belts, pulleys, or set screws\n- Worn\u002Fdirty linear bearings or rods\n- Z-axis binding or misalignment\n- Extruder gear worn or skipping\n\n**Thermal**:\n- Temperature sensor drift or failure\n- Inadequate heated bed power\u002Finsulation\n- Insufficient part cooling\n- Environmental temperature swings\n\n**Material**:\n- Wet filament (hygroscopic materials)\n- Old\u002Fdegraded material\n- Contaminated filament (dust, oils)\n- Wrong material for application\n\n**Configuration**:\n- Incorrect e-steps calibration\n- Wrong flow rate multiplier\n- Slicer bug or wrong profile\n- Firmware acceleration\u002Fjerk too high\n\n**Got:** Root cause identified with supporting evidence (measured temperatures, belt tension, visual inspection).\n\n**If fail:** If root cause unclear, use elimination method: fix most likely cause, re-test, repeat until resolved.\n\n### 4. Apply First-Level Fixes\n\nImplement immediate solutions for common issues:\n\n### Poor Bed Adhesion\n\n**Immediate fixes**:\n```bash\n# 1. Clean bed thoroughly\n# Glass\u002FPEI: Isopropyl alcohol 90%+\n# BuildTak: Warm water and dish soap\n\n# 2. Level bed (paper test at 4 corners + center)\n# Paper should drag slightly\n\n# 3. Adjust Z-offset down (squish first layer more)\n# Start: -0.05mm increments until lines fuse\n\n# 4. Increase bed temperature +5°C\n\n# 5. Add adhesion aid:\n# - Glue stick (PLA\u002FPETG)\n# - Hairspray (ABS)\n# - ABS juice (ABS) - ABS dissolved in acetone\n# - Magigoo\u002F3D printing adhesive\n```\n\n**Slicer settings**:\n- First layer height: 0.2-0.3mm (thicker = better squish)\n- First layer speed: 20mm\u002Fs (slower = better adhesion)\n- Add brim: 8-10mm for small footprint parts\n- Add raft: For very difficult materials (TPU, Nylon)\n\n**Got:** First layer adheres completely with no lifting.\n\n**If fail:** Check bed flatness with feeler gauge or mesh leveling; warped bed requires glass\u002FPEI sheet or mesh compensation.\n\n### Stringing\n\n**Temperature-first approach**:\n```\n1. Print temperature tower (180-220°C in 5° steps for PLA)\n2. Identify lowest temperature that extrudes cleanly\n3. Use that temperature -5°C to minimize stringing\n```\n\n**Retraction tuning**:\n```yaml\n# Direct drive extruder:\nretraction_distance: 1.0-2.0mm\nretraction_speed: 40-50mm\u002Fs\n\n# Bowden extruder:\nretraction_distance: 4.0-6.0mm\nretraction_speed: 40-60mm\u002Fs\n\n# If stringing persists:\n- Enable z-hop: 0.2-0.4mm (lifts nozzle during travel)\n- Reduce travel speed (paradoxically helps)\n- Enable combing mode (travels within infill)\n```\n\n**Got:** Minimal stringing, thin strings easily removed by hand.\n\n**If fail:** Check for nozzle partial clog or wet filament (both cause oozing).\n\n### Layer Shifts\n\n**Mechanical checks**:\n```bash\n# 1. Check belt tension (should twang like guitar string)\n# Tighten if loose\n\n# 2. Check pulley set screws (motor shafts)\n# Must align with flat on motor shaft\n\n# 3. Check for mechanical resistance\n# Manually move X\u002FY axes - should glide smoothly\n# Binding indicates dirty rods, worn bearings, or misalignment\n\n# 4. Check stepper motor current (advanced)\n# Too low → skipping; too high → overheating\n```\n\n**Speed reduction**:\n```yaml\n# Reduce these speeds:\nperimeter_speed: 40mm\u002Fs (from 50)\ntravel_speed: 120mm\u002Fs (from 150)\nacceleration: 500mm\u002Fs² (from 1000)\njerk: 8mm\u002Fs (from 15)\n```\n\n**Got:** No layer shifts in re-print with tightened belts and reduced speeds.\n\n**If fail:** Check for slicer-generated collisions (part cooling fan hitting model) or electrical issues (stepper driver overheating).\n\n### Warping\n\n**Thermal management**:\n```yaml\n# Increase bed temperature:\nPLA: 60°C → 65°C\nPETG: 80°C → 85°C\nABS: 100°C → 110°C\n\n# Disable\u002Freduce part cooling:\nfirst_layer_fan: 0%\nregular_fan: 25% max (ABS), 50% (PETG), 100% (PLA)\n\n# Enclose printer (critical for ABS\u002FASA):\n- Cardboard box (temporary)\n- Acrylic panels (permanent)\n- Target chamber temp: 40-50°C\n```\n\n**Adhesion enhancement**:\n- Add brim: 10-15mm for corners\n- Add \"mouse ears\": 15mm diameter discs at sharp corners\n- Chamfer bottom edges in model (45° × 1mm removes stress concentrator)\n\n**Got:** Part stays flat with no corner lifting.\n\n**If fail:** Material fundamentally unsuitable for printer (ABS on unenclosed printer)—switch to PETG or ASA.\n\n### Under-Extrusion\n\n**Quick fixes**:\n```bash\n# 1. Check for nozzle clog\n# Heat to print temp, manually push filament\n# Should extrude smoothly\n\n# 2. Cold pull cleaning (if partial clog)\n# Heat to 220°C, push cleaning filament through\n# Cool to 90°C, pull sharply - should remove debris\n\n# 3. Increase temperature +5-10°C\n# Higher temp = better flow\n\n# 4. Increase flow rate 2-5%\n# Slicer: Filament settings → Flow → 102-105%\n```\n\n**E-steps calibration**:\n```bash\n# 1. Mark filament 120mm above extruder\n# 2. Extrude 100mm: G1 E100 F100\n# 3. Measure remaining distance to mark\n# 4. Calculate: new_steps = current_steps × (100 \u002F actual_extruded)\n# 5. Set: M92 E\u003Cnew_steps>; M500 (save to EEPROM)\n```\n\n**Got:** Consistent extrusion with no gaps in perimeters or infill.\n\n**If fail:** Check for heat creep (cooling fan failure), worn extruder gear, or cracked extruder arm.\n\n### Over-Extrusion\n\n**Flow rate reduction**:\n```yaml\n# Reduce flow in 2% increments:\nextrusion_multiplier: 0.98 → 0.96 → 0.94\n\n# Signs of correct flow:\n- Smooth top surface (not overstuffed)\n- Perimeters don't bulge outward\n- Infill doesn't overfill and push layers apart\n```\n\n**Dimensional accuracy test**:\n```bash\n# Print 20mm calibration cube\n# Measure with calipers:\n# X\u002FY dimensions should be 20.0mm ± 0.1mm\n# If consistently oversized → reduce flow\n# If undersized → increase flow\n```\n\n**Got:** Accurate dimensions, smooth surfaces, no bulging.\n\n**If fail:** Re-calibrate e-steps (may be set too high).\n\n### 5. Verify Fix with Test Print\n\nConfirm resolution before attempting full print:\n\n**Test print selection**:\n- **Adhesion issues**: 20mm square × 5 layers (fast first layer test)\n- **Stringing**: Stringing test model (dual towers with travels)\n- **Layer shifts**: Tall thin test (stress mechanical system)\n- **Warping**: Large flat surface (200mm × 200mm × 0.4mm)\n- **Extrusion**: 20mm calibration cube (dimensional accuracy)\n\n**Got:** Test print succeeds with issue resolved.\n\n**If fail:** If test fails, issue not fully resolved or multiple issues present—repeat diagnosis focusing on remaining symptoms.\n\n### 6. Document Solution\n\nRecord successful fix for future reference:\n\n**Issue log template**:\n```yaml\ndate: 2026-02-16\nissue: \"Layer shifts at 50mm height\"\nsymptoms: \"X-axis shifts 10mm, happens consistently at same height\"\nprinter: \"Ender 3 V2\"\nmaterial: \"PETG, PolyMaker PolyLite\"\nroot_cause: \"Loose X-axis belt, pulley set screw not on flat\"\nsolution:\n  - \"Tightened X-axis belt to 120Hz resonance\"\n  - \"Realigned pulley set screw on motor shaft flat\"\n  - \"Reduced print speed to 40mm\u002Fs perimeter\"\nverification: \"Printed 100mm test cylinder - no shifts\"\nnotes: \"Check belt tension monthly, pulley tends to slip\"\n```\n\n**Got:** Issue documented with root cause and solution for knowledge base.\n\n**If fail:** Even unsuccessful troubleshooting attempts should be logged to avoid repeating failed solutions.\n\n## Validation Checklist\n\n- [ ] Failure symptoms documented with photos and specific observations\n- [ ] Issue classified using diagnostic reference table\n- [ ] Root cause identified (mechanical, thermal, material, or configuration)\n- [ ] Appropriate fix applied based on root cause category\n- [ ] Fix verified with test print before attempting full print\n- [ ] Solution documented in issue log with date, cause, and resolution\n- [ ] Environmental factors recorded (temperature, humidity, drafts)\n- [ ] Material condition checked (dry, contamination-free, stored properly)\n\n## Pitfalls\n\n1. **Changing multiple variables**: Adjust one parameter at a time; otherwise you won't know what fixed it (or made it worse)\n2. **Ignoring wet filament**: Hygroscopic materials (Nylon, TPU, PETG) absorb moisture causing bubbling, stringing, poor adhesion—always suspect wet filament first\n3. **Skipping mechanical checks**: Loose belts and worn components cause issues no amount of slicer tuning can fix\n4. **Temperature from internet**: Every printer\u002Fmaterial combination is unique—always run your own temperature tower\n5. **Over-tightening belts**: Too tight = premature bearing wear; aim for guitar string tension, not steel cable\n6. **Blaming slicer**: Slicer bugs are rare; 95% of issues are mechanical, thermal, or material-related\n7. **Not cleaning nozzle**: Partial clogs cause intermittent under-extrusion that looks like flow\u002Fe-step issues\n8. **Assuming bed is level**: Beds warp over time, springs compress, and adjustments slip—re-level weekly for reliable results\n9. **Wrong Z-offset**: Most first layer failures are Z-offset too high (not enough squish) or too low (nozzle scraping bed)\n10. **Environmental neglect**: ABS\u002FASA in 15°C garage with drafts will never print well—material requires stable warm environment\n\n## Related Skills\n\n- **[prepare-print-model](..\u002Fprepare-print-model\u002FSKILL.md)**: Ensure model is properly prepared to avoid printability issues\n- **[select-print-material](..\u002Fselect-print-material\u002FSKILL.md)**: Choose material appropriate for printer capabilities and environment\n- **Calibrate 3D Printer** (future skill): E-steps, flow rate, temperature towers, PID tuning, and bed mesh leveling\n- **Maintain 3D Printer** (future skill): Belt tensioning, bearing lubrication, nozzle replacement, and preventive maintenance\n","# Troubleshoot Print Issues\n\nDiagnose and fix common 3D printing failures using systematic symptom analysis. This skill covers the most frequent FDM and SLA issues: poor bed adhesion, stringing, layer shifts, warping, under-extrusion, over-extrusion, and print quality defects. Uses a structured approach of symptom identification, root cause analysis, and iterative fixes.\n\n## When to Use\n\n- Print fails during first layer or partway through\n- Finished prints have quality defects (stringing, blobs, gaps, rough surfaces)\n- Dimensional accuracy problems (over\u002Fundersized, warping, elephant foot)\n- Layer adhesion issues (delamination, splitting)\n- Support removal leaves damage or supports fail during print\n- Prints look different from slicer preview\n- Material behaves inconsistently across prints\n- New material, printer, or environmental conditions causing issues\n\n## Inputs\n\n- **failure_description**: What went wrong (failed first layer, stringing, warping, etc.)\n- **failure_timing**: When issue occurs (first layer, midprint, specific height, top layers)\n- **material**: Filament\u002Fresin type, brand, age, storage conditions\n- **printer**: Make\u002Fmodel, nozzle size, bed type, enclosure\n- **recent_changes**: New material, slicer settings, hardware modifications, environment\n- **print_history**: Does this model usually work? Did this material work before?\n\n## Procedure\n\n### 1. Collect Failure Symptoms\n\nDocument observable symptoms with specificity:\n\n**Visual inspection**:\n- Take photos of failure (overall, close-up, specific defect)\n- Note failure location (first layer, specific height, top surface)\n- Describe defect type: gaps, blobs, strings, shifts, cracks\n\n**Environmental data**:\n- Ambient temperature during print\n- Humidity level\n- Drafts or AC affecting printer\n- Time of day (temperature changes)\n\n**Print parameters**:\n```bash\n# Extract from G-code metadata\ngrep \"^;MAXX\\|^;MINX\\|^;MAXZ\" failed_print.gcode  # Print dimensions\ngrep \"^;PRINT_TIME:\" failed_print.gcode  # Estimated time\ngrep \"^M104\\|^M140\" failed_print.gcode | head -5  # Temperatures\ngrep \"^;generated by\" failed_print.gcode  # Slicer version\n```\n\n**Got:** Detailed symptom description with photos, parameters, and environmental context.\n\n**If fail:** If symptoms unclear, print a calibration test (temperature tower, stringing test, or benchy) to reproduce and observe failure systematically.\n\n### 2. Classify Issue by Symptom Pattern\n\nMatch observed symptoms to common failure modes:\n\n## Diagnostic Reference Table\n\n| Symptom | Likely Causes | Quick Check | Priority Fix |\n|---------|--------------|-------------|--------------|\n| **Poor bed adhesion** | Dirty bed, wrong temp, too high Z | Wipe bed, level bed | Clean bed, adjust Z-offset down 0.05mm |\n| **Stringing** | Too hot, insufficient retraction | Check nozzle temp | Lower temp 5°C, increase retraction +0.5mm |\n| **Layer shifts** | Loose belts, too fast, collision | Check belt tension | Tighten belts, reduce speed 20% |\n| **Warping** | Poor adhesion, fast cooling | Check corners lifting | Add brim, enclose printer, increase bed temp |\n| **Under-extrusion** | Clog, low temp, wrong flow | Check extrusion consistency | Clean nozzle, increase temp 5°C, calibrate e-steps |\n| **Over-extrusion** | High flow rate, wrong e-steps | Check blob formation | Reduce flow 2-5%, calibrate e-steps |\n| **Elephant foot** | First layer squish, bed too hot | Measure base width | Raise Z-offset +0.05mm, lower bed temp 5°C |\n| **Gaps in walls** | Thin walls, under-extrusion | Check wall thickness | Enable thin wall detection, increase flow |\n| **Layer delamination** | Low temp, poor cooling, contamination | Check layer lines | Increase temp 5-10°C, check wet filament |\n| **Blobs\u002Fzits** | Retraction, coast settings | Check seam alignment | Tune retraction, enable coasting |\n| **Rough top surface** | Insufficient top layers, ironing | Count solid top layers | Add 2 top layers, enable ironing |\n| **Sagging overhangs** | Insufficient cooling, too hot | Check part cooling fan | Increase cooling, lower temp, add supports |\n\n**Got:** Failure classified into 1-3 most likely categories.\n\n**If fail:** If symptoms match multiple categories, prioritize based on failure timing (first layer issues first, then midprint, then top surface).\n\n### 3. Perform Root Cause Analysis\n\nInvestigate underlying cause, not just symptoms:\n\n**5 Whys technique**:\n```\nSymptom: Print warping and lifting from bed\nWhy? → Poor bed adhesion in corners\nWhy? → Corners cooling faster than center\nWhy? → Room draft from AC vent\nWhy? → No enclosure to maintain stable temperature\nWhy? → ABS requires heated chamber for uniform cooling\n\nRoot cause: Material choice (ABS) incompatible with open printer in drafty room\n```\n\n**Common root causes by category**:\n\n**Mechanical**:\n- Loose belts, pulleys, or set screws\n- Worn\u002Fdirty linear bearings or rods\n- Z-axis binding or misalignment\n- Extruder gear worn or skipping\n\n**Thermal**:\n- Temperature sensor drift or failure\n- Inadequate heated bed power\u002Finsulation\n- Insufficient part cooling\n- Environmental temperature swings\n\n**Material**:\n- Wet filament (hygroscopic materials)\n- Old\u002Fdegraded material\n- Contaminated filament (dust, oils)\n- Wrong material for application\n\n**Configuration**:\n- Incorrect e-steps calibration\n- Wrong flow rate multiplier\n- Slicer bug or wrong profile\n- Firmware acceleration\u002Fjerk too high\n\n**Got:** Root cause identified with supporting evidence (measured temperatures, belt tension, visual inspection).\n\n**If fail:** If root cause unclear, use elimination method: fix most likely cause, re-test, repeat until resolved.\n\n### 4. Apply First-Level Fixes\n\nImplement immediate solutions for common issues:\n\n### Poor Bed Adhesion\n\n**Immediate fixes**:\n```bash\n# 1. Clean bed thoroughly\n# Glass\u002FPEI: Isopropyl alcohol 90%+\n# BuildTak: Warm water and dish soap\n\n# 2. Level bed (paper test at 4 corners + center)\n# Paper should drag slightly\n\n# 3. Adjust Z-offset down (squish first layer more)\n# Start: -0.05mm increments until lines fuse\n\n# 4. Increase bed temperature +5°C\n\n# 5. Add adhesion aid:\n# - Glue stick (PLA\u002FPETG)\n# - Hairspray (ABS)\n# - ABS juice (ABS) - ABS dissolved in acetone\n# - Magigoo\u002F3D printing adhesive\n```\n\n**Slicer settings**:\n- First layer height: 0.2-0.3mm (thicker = better squish)\n- First layer speed: 20mm\u002Fs (slower = better adhesion)\n- Add brim: 8-10mm for small footprint parts\n- Add raft: For very difficult materials (TPU, Nylon)\n\n**Got:** First layer adheres completely with no lifting.\n\n**If fail:** Check bed flatness with feeler gauge or mesh leveling; warped bed requires glass\u002FPEI sheet or mesh compensation.\n\n### Stringing\n\n**Temperature-first approach**:\n```\n1. Print temperature tower (180-220°C in 5° steps for PLA)\n2. Identify lowest temperature that extrudes cleanly\n3. Use that temperature -5°C to minimize stringing\n```\n\n**Retraction tuning**:\n```yaml\n# Direct drive extruder:\nretraction_distance: 1.0-2.0mm\nretraction_speed: 40-50mm\u002Fs\n\n# Bowden extruder:\nretraction_distance: 4.0-6.0mm\nretraction_speed: 40-60mm\u002Fs\n\n# If stringing persists:\n- Enable z-hop: 0.2-0.4mm (lifts nozzle during travel)\n- Reduce travel speed (paradoxically helps)\n- Enable combing mode (travels within infill)\n```\n\n**Got:** Minimal stringing, thin strings easily removed by hand.\n\n**If fail:** Check for nozzle partial clog or wet filament (both cause oozing).\n\n### Layer Shifts\n\n**Mechanical checks**:\n```bash\n# 1. Check belt tension (should twang like guitar string)\n# Tighten if loose\n\n# 2. Check pulley set screws (motor shafts)\n# Must align with flat on motor shaft\n\n# 3. Check for mechanical resistance\n# Manually move X\u002FY axes - should glide smoothly\n# Binding indicates dirty rods, worn bearings, or misalignment\n\n# 4. Check stepper motor current (advanced)\n# Too low → skipping; too high → overheating\n```\n\n**Speed reduction**:\n```yaml\n# Reduce these speeds:\nperimeter_speed: 40mm\u002Fs (from 50)\ntravel_speed: 120mm\u002Fs (from 150)\nacceleration: 500mm\u002Fs² (from 1000)\njerk: 8mm\u002Fs (from 15)\n```\n\n**Got:** No layer shifts in re-print with tightened belts and reduced speeds.\n\n**If fail:** Check for slicer-generated collisions (part cooling fan hitting model) or electrical issues (stepper driver overheating).\n\n### Warping\n\n**Thermal management**:\n```yaml\n# Increase bed temperature:\nPLA: 60°C → 65°C\nPETG: 80°C → 85°C\nABS: 100°C → 110°C\n\n# Disable\u002Freduce part cooling:\nfirst_layer_fan: 0%\nregular_fan: 25% max (ABS), 50% (PETG), 100% (PLA)\n\n# Enclose printer (critical for ABS\u002FASA):\n- Cardboard box (temporary)\n- Acrylic panels (permanent)\n- Target chamber temp: 40-50°C\n```\n\n**Adhesion enhancement**:\n- Add brim: 10-15mm for corners\n- Add \"mouse ears\": 15mm diameter discs at sharp corners\n- Chamfer bottom edges in model (45° × 1mm removes stress concentrator)\n\n**Got:** Part stays flat with no corner lifting.\n\n**If fail:** Material fundamentally unsuitable for printer (ABS on unenclosed printer)—switch to PETG or ASA.\n\n### Under-Extrusion\n\n**Quick fixes**:\n```bash\n# 1. Check for nozzle clog\n# Heat to print temp, manually push filament\n# Should extrude smoothly\n\n# 2. Cold pull cleaning (if partial clog)\n# Heat to 220°C, push cleaning filament through\n# Cool to 90°C, pull sharply - should remove debris\n\n# 3. Increase temperature +5-10°C\n# Higher temp = better flow\n\n# 4. Increase flow rate 2-5%\n# Slicer: Filament settings → Flow → 102-105%\n```\n\n**E-steps calibration**:\n```bash\n# 1. Mark filament 120mm above extruder\n# 2. Extrude 100mm: G1 E100 F100\n# 3. Measure remaining distance to mark\n# 4. Calculate: new_steps = current_steps × (100 \u002F actual_extruded)\n# 5. Set: M92 E\u003Cnew_steps>; M500 (save to EEPROM)\n```\n\n**Got:** Consistent extrusion with no gaps in perimeters or infill.\n\n**If fail:** Check for heat creep (cooling fan failure), worn extruder gear, or cracked extruder arm.\n\n### Over-Extrusion\n\n**Flow rate reduction**:\n```yaml\n# Reduce flow in 2% increments:\nextrusion_multiplier: 0.98 → 0.96 → 0.94\n\n# Signs of correct flow:\n- Smooth top surface (not overstuffed)\n- Perimeters don't bulge outward\n- Infill doesn't overfill and push layers apart\n```\n\n**Dimensional accuracy test**:\n```bash\n# Print 20mm calibration cube\n# Measure with calipers:\n# X\u002FY dimensions should be 20.0mm ± 0.1mm\n# If consistently oversized → reduce flow\n# If undersized → increase flow\n```\n\n**Got:** Accurate dimensions, smooth surfaces, no bulging.\n\n**If fail:** Re-calibrate e-steps (may be set too high).\n\n### 5. Verify Fix with Test Print\n\nConfirm resolution before attempting full print:\n\n**Test print selection**:\n- **Adhesion issues**: 20mm square × 5 layers (fast first layer test)\n- **Stringing**: Stringing test model (dual towers with travels)\n- **Layer shifts**: Tall thin test (stress mechanical system)\n- **Warping**: Large flat surface (200mm × 200mm × 0.4mm)\n- **Extrusion**: 20mm calibration cube (dimensional accuracy)\n\n**Got:** Test print succeeds with issue resolved.\n\n**If fail:** If test fails, issue not fully resolved or multiple issues present—repeat diagnosis focusing on remaining symptoms.\n\n### 6. Document Solution\n\nRecord successful fix for future reference:\n\n**Issue log template**:\n```yaml\ndate: 2026-02-16\nissue: \"Layer shifts at 50mm height\"\nsymptoms: \"X-axis shifts 10mm, happens consistently at same height\"\nprinter: \"Ender 3 V2\"\nmaterial: \"PETG, PolyMaker PolyLite\"\nroot_cause: \"Loose X-axis belt, pulley set screw not on flat\"\nsolution:\n  - \"Tightened X-axis belt to 120Hz resonance\"\n  - \"Realigned pulley set screw on motor shaft flat\"\n  - \"Reduced print speed to 40mm\u002Fs perimeter\"\nverification: \"Printed 100mm test cylinder - no shifts\"\nnotes: \"Check belt tension monthly, pulley tends to slip\"\n```\n\n**Got:** Issue documented with root cause and solution for knowledge base.\n\n**If fail:** Even unsuccessful troubleshooting attempts should be logged to avoid repeating failed solutions.\n\n## Validation Checklist\n\n- [ ] Failure symptoms documented with photos and specific observations\n- [ ] Issue classified using diagnostic reference table\n- [ ] Root cause identified (mechanical, thermal, material, or configuration)\n- [ ] Appropriate fix applied based on root cause category\n- [ ] Fix verified with test print before attempting full print\n- [ ] Solution documented in issue log with date, cause, and resolution\n- [ ] Environmental factors recorded (temperature, humidity, drafts)\n- [ ] Material condition checked (dry, contamination-free, stored properly)\n\n## Pitfalls\n\n1. **Changing multiple variables**: Adjust one parameter at a time; otherwise you won't know what fixed it (or made it worse)\n2. **Ignoring wet filament**: Hygroscopic materials (Nylon, TPU, PETG) absorb moisture causing bubbling, stringing, poor adhesion—always suspect wet filament first\n3. **Skipping mechanical checks**: Loose belts and worn components cause issues no amount of slicer tuning can fix\n4. **Temperature from internet**: Every printer\u002Fmaterial combination is unique—always run your own temperature tower\n5. **Over-tightening belts**: Too tight = premature bearing wear; aim for guitar string tension, not steel cable\n6. **Blaming slicer**: Slicer bugs are rare; 95% of issues are mechanical, thermal, or material-related\n7. **Not cleaning nozzle**: Partial clogs cause intermittent under-extrusion that looks like flow\u002Fe-step issues\n8. **Assuming bed is level**: Beds warp over time, springs compress, and adjustments slip—re-level weekly for reliable results\n9. **Wrong Z-offset**: Most first layer failures are Z-offset too high (not enough squish) or too low (nozzle scraping bed)\n10. **Environmental neglect**: ABS\u002FASA in 15°C garage with drafts will never print well—material requires stable warm environment\n\n## Related Skills\n\n- **[prepare-print-model](..\u002Fprepare-print-model\u002FSKILL.md)**: Ensure model is properly prepared to avoid printability issues\n- **[select-print-material](..\u002Fselect-print-material\u002FSKILL.md)**: Choose material appropriate for printer capabilities and environment\n- **Calibrate 3D Printer** (future skill): E-steps, flow rate, temperature towers, PID tuning, and bed mesh leveling\n- **Maintain 3D Printer** (future skill): Belt tensioning, bearing lubrication, nozzle replacement, and preventive maintenance\n",{"name":5,"locale":23,"license":14,"metadata":24,"translator":31,"description":32,"allowed-tools":33,"source_commit":34,"source_locale":35,"translation_date":36},"caveman-lite",{"tags":25,"author":26,"domain":27,"version":28,"language":29,"complexity":30},"3d-printing, troubleshooting, fdm, sla, print-quality, failures","Philipp Thoss","3d-printing","1.0","multi","intermediate","Julius Brussee homage — caveman","Diagnose and fix common 3D printing failures through systematic symptom analysis. Covers adhesion, stringing, layer shifts, warping, and under\u002Fover-extrusion issues. Use when a print fails during the first layer or partway through, finished prints have quality defects (stringing, blobs, gaps), dimensional accuracy issues occur (warping, elephant foot), layer adhesion fails, or new material or hardware changes are causing inconsistent results.\n","Read Write Edit Bash Grep Glob WebFetch","82c77053","en","2026-05-03","master","f483e54f3ad5f202a77d45f2e57f8d970b71195f","skills_library\u002Ftroubleshoot-print-issues",2,"https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills","https:\u002F\u002Fgithub.com\u002Froohe","yoou.link","2026-05-19 15:56:07",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":57},[47,50,53],{"tool":48,"command":49},"npx","npx skills add roohe\u002Fagentic-super-skills --skill troubleshoot-print-issues",{"tool":51,"command":52},"bunx","bunx skills add roohe\u002Fagentic-super-skills --skill troubleshoot-print-issues",{"tool":54,"command":55},"pnpm","pnpm dlx skills add roohe\u002Fagentic-super-skills --skill troubleshoot-print-issues","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Ftroubleshoot-print-issues\u002FSKILL.md",true,[],[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M73D865CZME2FCMKA4PQM348","zarr-python","Chunked N-D arrays for cloud storage. Compressed arrays, parallel I\u002FO, S3\u002FGCS integration, NumPy\u002FDask\u002FXarray compatible, for large-scale scientific computing pipelines.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fzarr-python\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M73D7Z64J4ABWZJD7P44XBBF","youtube-downloader","Download and process YouTube content for research. Use when: downloading competitor videos for analysis; extracting audio for podcasts; getting transcripts for content repurposing; archiving webinars; research content curation","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fyoutube-downloader\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M73D7K8778TGZV3GJFR3703D","yc-pitch-deck","Create a compelling startup pitch deck that follows the structure proven to raise billions from top investors. Master the YC and Sequoia formats that get founders funded. Use when: **Fundraising** to create investor pitch decks; **YC application** to structure your narrative; **Demo Day prep** to craft your 2-minute pitch; **Angel investors** to communicate your opportunity; **Partnership pitches** to structure compelling asks","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fyc-pitch-deck\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M73D70KJSE0E8Z28YMNNRT04","x-twitter-scraper","Use when the user needs X (Twitter) data or confirmation-gated X actions through Xquik: tweet search, user lookup, follower extraction, media download, monitoring, webhooks, MCP, SDKs, posting, likes, DMs, and profile updates. Requires a Xquik API key. Never ask for X login material.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fx-twitter-scraper\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M73D6ED01GV077R7K4NZNFZJ","write-vignette","Create R package vignettes using R Markdown or Quarto. Covers vignette setup, YAML configuration, code chunk options, building and testing, and CRAN requirements for vignettes. Use when adding a Getting Started tutorial, documenting complex workflows spanning multiple functions, creating domain-specific guides, or when CRAN submission requires user-facing documentation beyond function help pages.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fwrite-vignette\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M73D69YJR0BK3NFHE0CYG3EF","write-validation-documentation","Write IQ\u002FOQ\u002FPQ validation documentation for computerized systems in regulated environments. Covers protocols, reports, test scripts, deviation handling, and approval workflows. Use when validating R or other software for regulated use, preparing for a regulatory audit, documenting qualification of computing environments, or creating and updating validation protocols and reports for new or re-qualified systems.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fwrite-validation-documentation\u002FSKILL.md",[],[]]