Drawings to build from
Drawings for the person holding the saw. Drawn from the model, so they always match the design and the shopping list. On the media wall they went to the tradesman building the frame (a family member) to review on an iPad, then were printed for build day. Before printing, the owner asked for A4 and "the less writing the better"; the tradesman's review was that the frame looked too complicated, which simplified the design itself.
Start with the task
<skill-dir> means this skill's own folder: the base directory shown when the skill loads (for a personal install, ~/.claude/skills/build-drawings).
| Task | Start with | Go deeper |
|---|---|---|
| Any drawing set | scripts/drawkit.py (copy into the project, or import it) | references/sheet-recipes.md |
| Frame drawings (stud walls, breasts, boxes) | Overview, elevations, plans/sections, cutting list | sheet-recipes.md |
| A cutting diagram for each sheet of board | One A4 page per sheet, 1:10 | sheet-recipes.md |
| Look at the pages yourself | page_pngs(svgs, "out/pages"), then Read each PNG | below |
| Run the demo | python3 <skill-dir>/scripts/drawkit.py /tmp/demo.pdf | - |
drawkit.py has no dependencies: SVG in paper millimetres, one HTML file with a page per
sheet, printed to PDF by headless Google Chrome (--no-pdf-header-footer, @page sized to
the paper). Without Chrome, open the HTML in any browser and print with no margins.
What makes drawings usable on site
- A4 landscape. Lay sheets out on an A3 grid and shrink to A4 (text 3.5 on the grid prints about 7 pt). Then they're not to scale, so every sheet says "Don't scale: use the figures". For sheet cutting diagrams, draw at true 1:10 on A4 instead (a 2440 sheet is 244 mm across).
- Few words. One-line notes. A red "Check first" list of site checks (ceiling height at both ends, the stud positions, a pilot hole before relying on a joist) and a short "Remember" list (carpet and skirting off, never cut into the existing wall, don't board until cables are in). The first version had paragraphs; cut to one-liners, it was better.
- Leave the trade's choices to the trade. "Fixings: your call. Into studs and joists." An expert doesn't need screw sizes; they need to know what must be fixed to what.
- Piece marks. Every piece gets a letter for what it is and a number for its length (S1 = longest stud, P2, N1...). The same marks on the elevations, the cutting list and the cutting plan. Identical pieces share a mark, so the cutting list is short.
- "Ceiling not 2300?" column. Pieces that run floor to ceiling are listed as "ceiling less 76" as well as a length, so a ceiling that's 10 mm out doesn't need new drawings.
- Running dimensions, all measured from one end, not chains: errors can't add up. Mark the datum ("from the left corner", "from the factory edge").
- The cutting plan uses the same stock lengths and plan as the shopping list, so what was bought is what the plan cuts. "Get one or two spare."
- Colour helps on an iPad (timber tan, dimensions blue, warnings red) and still reads printed in grey.
- Dated, numbered, titled: "3. Back frame, on the wall. Sheet 3 of 5." in a title box.
Check each change
You can't see a PDF directly (the Read tool needs poppler for PDFs), so render each sheet to a PNG and look at every page before telling anyone it's ready:
pngs = dk.page_pngs(svgs, "out/pages") # then Read out/pages/page-1.png, page-2.png ...
| Look for | Why |
|---|---|
| Labels overlapping, text past the border or into the title box | the commonest fault; spread() and View.label() help but don't catch everything |
| Every mark on a drawing has a cutting-list row, and the counts match the model | the list is what gets cut |
| Totals (pieces, metres, lengths to buy) match the BOM summary | one source of truth |
| Notes column fits and says nothing twice | fewer words |
| A piece that floats (fixed to nothing) or a dimension that's missing | easy to see in a picture, hard in numbers |
Then print the PDF, and say how many pages and what's on each.