Skip to content

Skill Builder Troubleshooting

Symptom Likely cause Fix
command not found Extra not installed / venv inactive pip install -e ".[(base]"
Import error for backend Missing optional dependency Install correct extra (image-ocr, etc.)
HTTP 413 Upload too large Raise env limit or use job endpoint
Empty Markdown Wrong options or unsupported input variant Re-run with -v, verify input sample
Job stuck Worker crash / disk full Check API logs; clean temp dir

Debug commands

mdengine skill build --help
python -c "import md_generator.tools.skill_builder; print('ok')"