@structupath/pi-steel 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StructuPath LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# pi-steel
+
+Structural steel estimating skills for the [Pi coding agent](https://pi.dev) — built by working steel estimators, not by people guessing what a takeoff is.
+
+By [StructuPath](https://structupath.ai), from the team behind a production structural-steel fabrication shop in Denver, CO.
+
+## Install
+
+```bash
+pi install npm:@structupath/pi-steel
+```
+
+## What's Inside
+
+### `steel-takeoff` — takeoffs, BOMs, tonnage
+
+Structural steel quantity takeoff with a bundled **AISC 16th Edition shapes database (477 shapes)** — W, HSS, angles, channels, pipe — plus scripts the agent runs directly:
+
+- `lookup-member.sh` — full property set for any AISC designation (`W14X30` → plf, d, bf, A, Ix, Sx, …)
+- `calculate-weight.sh` — BOM totals with connection and misc-steel allowances, tonnage, cost sensitivity
+- `validate-bom.py` — catches invalid designations, wrong grades, duplicate marks, unreasonable weights
+
+Also includes reference guides for AISC shape families, takeoff procedures with worked examples, connection types and hardware weights, material grades, and bolt capacities.
+
+Ask your agent things like:
+
+> "Do a takeoff from these drawings and build me a BOM"
+> "What's the lightest W-shape with depth ≥ 18" and Ix ≥ 1000?"
+> "Total tonnage on this BOM with 12% connections"
+
+### `steel-rfq` — vendor quote requests
+
+Turns a steel estimate/takeoff spreadsheet into a standardized vendor RFQ (.xlsx): materials grouped the way vendors stock them (W-shapes / plate / flat bar), yellow fill-in pricing columns, nesting/drop reference, and terms & conditions — branded with **your** company profile.
+
+One-time setup: copy `skills/steel-rfq/assets/company-profile.example.json` to `company-profile.json` and put in your company name, city, and payment terms. The skill will ask and offer to save it if you skip this.
+
+> "Send this takeoff out for pricing"
+> "Generate an RFQ from this estimate"
+
+## Requirements
+
+- `jq` and `python3` (with `pandas` + `openpyxl` for RFQ generation)
+- macOS or Linux
+
+## License
+
+MIT. AISC shape data derived from the publicly available AISC Shapes Database v16.0.
+
+---
+
+Building software for steel fabricators? See [structupath.ai](https://structupath.ai).

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@structupath/pi-steel",
+  "version": "0.1.0",
+  "description": "Structural steel estimating skills for the Pi coding agent — AISC takeoffs, bills of material, tonnage calcs, and vendor RFQ generation.",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi-skill",
+    "steel",
+    "structural-steel",
+    "estimating",
+    "takeoff",
+    "aisc",
+    "bom",
+    "rfq",
+    "construction",
+    "fabrication"
+  ],
+  "author": "StructuPath (https://structupath.ai)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/StructuPath/pi-steel.git"
+  },
+  "homepage": "https://structupath.ai",
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "pi": {
+    "skills": ["./skills"]
+  },
+  "files": [
+    "skills",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/skills/steel-rfq/SKILL.md

@@ -0,0 +1,178 @@
+---
+name: steel-rfq
+description: "Generate standardized Request for Quotation (RFQ) spreadsheets from steel estimate takeoff files. Use this skill whenever someone mentions RFQ, request for quote, vendor quote, material quote, sending a material list to vendors, quoting steel, or getting pricing from a supplier. Also trigger when someone uploads a steel estimate or takeoff spreadsheet and wants to send it out for pricing. Even if they just say 'I need to send this to my vendor' or 'get me prices on this material' — that's an RFQ."
+---
+
+# Steel RFQ Generator
+
+## What This Skill Does
+
+This skill takes a steel estimate/takeoff spreadsheet (.xlsx) and produces a clean, standardized RFQ spreadsheet that can be sent directly to steel vendors. The output is always an Excel file with a consistent layout so every vendor gets the same professional format regardless of who creates it.
+
+The RFQ format was designed around how steel vendors actually work — materials grouped by type (W-shapes, plates, flat bar) so vendors can quickly identify what they have in stock, quote pricing, and flag what they don't carry.
+
+## Company Profile (required setup)
+
+The RFQ carries the requesting company's identity. Load it from
+`assets/company-profile.json` in this skill's directory (copy
+`company-profile.example.json` and edit). If the file is missing, ask the
+user for their company name, city/state, and payment terms before
+generating, and offer to save the answers as `company-profile.json` for
+next time.
+
+Profile fields:
+- `company_name` — appears in the header and terms & conditions
+- `city_state` — appears in the header (e.g., "Denver, CO")
+- `payment_terms` — default "Net 30 from date of delivery"
+- `quote_validity_days` — default 30
+- `logo` — optional filename in `assets/` to embed top-left
+
+Never invent company details. If the profile is incomplete, ask.
+
+## Input
+
+Always a steel estimate spreadsheet (.xlsx). These files typically have:
+- A "Steel Takeoff" sheet (or similar) with line items for structural members, plates, and connection hardware
+- Item numbers (A-01, B-01, C-01, etc.), categories, descriptions, sizes, quantities, stock lengths, and weights
+- Items marked "BY OTHERS" (typically purlins) that are NOT part of the fabricator's scope
+
+The first step is always to read and understand the takeoff data before generating the RFQ.
+
+## Reading the Estimate
+
+1. Use pandas to read all sheets: `pd.ExcelFile(path)` then inspect sheet names
+2. Find the takeoff sheet (look for "Takeoff", "Steel Takeoff", "Material List", "BOM", or the sheet with item-level steel data)
+3. Read the full sheet with `header=None` to capture all rows including section headers
+4. Identify the data structure:
+   - Section headers (e.g., "A. MAIN BUILDING — W-SHAPES")
+   - Column headers (Item, Category, Description, Size, Qty, Length, Weight, Stock Purchase, Purchase Wt, Notes)
+   - Line items with actual material data
+   - Items with "BY OTHERS" in the description — these get **excluded**
+   - Subtotal and total rows
+
+## RFQ Output Format
+
+The output is always a single .xlsx file with this exact structure:
+
+### Header Block (Rows 1–3)
+- **Row 1**: "REQUEST FOR QUOTATION — Structural Steel" — dark blue background (#1F3864), white bold Arial 14pt, merged across all columns
+- **Row 2**: "[Project Name] | [Company Name] — [City, ST]" — same dark blue, white bold Arial 11pt
+- **Row 3**: "Date Issued: [today] | Response Requested By: _______________ | Project Location: [location]" — same dark blue, white Arial 10pt
+
+### Vendor Info Block (Rows 4–6)
+Fillable fields for the vendor:
+- Row 5: Company Name (merged A–B, input in C–E yellow) | Contact Name (merged F–G, input in H–J yellow)
+- Row 6: Phone/Email (merged A–B, input in C–E yellow) | Quote Valid Until (merged F–G, input in H–J yellow)
+
+### Instructions Row (Row 7)
+Single merged row with italic gray text explaining how to fill out the yellow columns. Text:
+> "Instructions: Please fill in the YELLOW columns (Unit Price, Total Price, Availability, Lead Time, Alternate Size, Notes). Mark Availability as 'In Stock', 'Lead Time', or 'Unavailable'. If suggesting an alternate size, list it and adjust pricing accordingly."
+
+### Column Headers (Row 8)
+14 columns with medium blue background (#2E75B6), white bold Arial 10pt:
+
+| Column | Header | Width | Purpose |
+|--------|--------|-------|---------|
+| A | Item | 7 | Item number from estimate (A-01, C-02, E-01, etc.) |
+| B | Category | 13 | Columns, Girders, Plate, Flat Bar, etc. |
+| C | Description | 38 | Full description including which structure it belongs to |
+| D | Size / Designation | 22 | AISC shape or plate dimensions |
+| E | Grade | 12 | A992 Gr.50, A572 Gr.50, A36, etc. |
+| F | Qty | 6 | Number of pieces or sticks needed |
+| G | Stock Length / Size | 20 | How it's being purchased (e.g., "3 sticks × 30′") |
+| H | Est. Purchase Wt (lbs) | 20 | Weight from the estimate |
+| I | Unit Price ($) | 14 | **VENDOR FILLS** — yellow background |
+| J | Total Price ($) | 14 | **VENDOR FILLS** — yellow background |
+| K | Availability | 14 | **VENDOR FILLS** — yellow background |
+| L | Lead Time (days) | 14 | **VENDOR FILLS** — yellow background |
+| M | Alternate Size | 18 | **VENDOR FILLS** — yellow background |
+| N | Notes | 30 | **VENDOR FILLS** — yellow background |
+
+Vendor columns (I–N) get a darker gold header (#BF8F00) to distinguish them from the material data columns.
+
+### Material Data Rows
+
+**Grouping**: Always group by material type, not by structure. The three groups are:
+1. **W-SHAPES — [Grade]** (columns and girders from all structures combined)
+2. **PLATE STOCK — [Grade]** (all plate material)
+3. **FLAT BAR STOCK — [Grade]** (all flat bar material)
+
+Each group gets a section header row: merged across all columns, medium blue background, white bold text.
+
+**Data rows**:
+- Alternate row shading: light blue (#D6E4F0) and white
+- Vendor columns (I–N) always have yellow background (#FFF2CC) regardless of row
+- Weight column (H) formatted as `#,##0`
+- Price columns (I–J) formatted as `$#,##0.00`
+- All cells have thin borders
+
+**Filtering rules**:
+- EXCLUDE any item where the description contains "BY OTHERS" (purlins, etc.)
+- EXCLUDE any item where Qty = 0
+- If the estimate has a "Stock Purchase" section (Section E or similar) with consolidated purchase items for plates/flat bar, use those instead of the individual connection plate items. The stock purchase items represent what's actually being ordered (full sheets, full bars), which is what the vendor needs to quote.
+- Keep individual W-shape items because each shape/length combination matters for vendor stock
+
+### Totals Row
+- "TOTAL PURCHASE WEIGHT / PRICE" label merged A–G, right-aligned bold
+- Column H: `=SUM(H[first]:H[last])` formula for total weight, green background (#E2EFDA)
+- Column J: `=SUM(J[first]:J[last])` formula for total price, green background
+
+### Nesting / Drop Reference Table
+Below the totals (skip a row), add a reference section:
+- Header: "NESTING / DROP REFERENCE (For Fabricator Use)" — dark blue bold text
+- Three columns: Material | Nesting Plan | Drop Notes
+- Column headers with medium blue background
+- One row per material showing the nesting layout and expected drop from the estimate
+- This helps cross-check vendor stock lengths against the cutting plan
+
+### Standard Terms & Conditions
+Below the nesting table (skip a row), add:
+- Header: "TERMS & CONDITIONS" — dark blue bold text
+- Include these standard terms, each on its own row, substituting the company name and payment terms from the company profile:
+
+1. **Delivery**: All material to be delivered FOB jobsite unless otherwise agreed. Vendor to confirm freight costs separately.
+2. **Mill Certifications**: Mill test reports (MTRs) required for all structural steel per AISC/AWS standards. Certs must accompany delivery.
+3. **Payment Terms**: [payment_terms from profile] unless otherwise negotiated in writing.
+4. **Material Standards**: All wide-flange shapes to meet ASTM A992. All plate and bar to meet grade specified on this RFQ (A572 Gr.50 or A36).
+5. **Substitutions**: No substitutions without prior written approval from [Company Name]. If quoting alternate sizes, clearly note in the "Alternate Size" column.
+6. **Quote Validity**: Quoted prices to remain firm for [quote_validity_days] days from date of quote unless otherwise stated.
+7. **Inspection**: [Company Name] reserves the right to inspect material upon delivery and reject material not meeting specifications.
+8. **Cancellation**: Orders may be cancelled without penalty if material has not shipped. Restocking fees, if any, to be stated in quote.
+
+### Branding / Logo
+If the company profile names a logo file and it exists in the skill's `assets/` directory, insert it in cell A1 area (top-left) and adjust the header text to not overlap. Otherwise use the text header as described above.
+
+## Print Setup
+- Orientation: Landscape
+- Fit to width: 1 page
+- Fit to height: 0 (auto)
+- Print title rows: Row 8 (column headers repeat on each page)
+
+## File Naming
+Output file: `[ProjectName]_RFQ_Material_List.xlsx`
+- Extract project name from the estimate file (look in "Project Info" sheet or the first rows of the takeoff)
+- Replace spaces with underscores
+- Example: `Cherokee_Boys_RFQ_Material_List.xlsx`
+
+## Step-by-Step Workflow
+
+1. Load the company profile (or collect it from the user — see Company Profile above)
+2. Read the uploaded estimate file with pandas to understand its structure
+3. Identify the takeoff sheet and parse all line items
+4. Filter out "BY OTHERS" items and zero-quantity items
+5. Group remaining items by material type (W-shapes → Plates → Flat Bar)
+6. If there's a stock purchase section, use those for plates/flat bar instead of individual pieces
+7. Build the RFQ spreadsheet using openpyxl following the format above
+8. Add formulas for totals and verify the SUM ranges cover exactly the data rows (formulas calculate when the vendor opens the file in Excel)
+9. Add nesting/drop reference from the estimate notes
+10. Add standard terms & conditions with profile values substituted
+11. Insert logo if configured
+12. Save the file and present it to the user
+
+## Common Variations
+
+**Multiple structures in one project**: Combine all materials into one RFQ, but note which structure each item belongs to in the Description column (e.g., "W12×65 Columns (Bldg A)").
+
+**Plate stock with nesting**: When plates are purchased as full sheets and then cut, show the full sheet as the line item (that's what the vendor ships) and put the cutting plan in the nesting reference table.
+
+**Mixed grades**: Group by material type first, then note the grade in each row. If a project has A992, A572, and A36, they all appear in the appropriate material type section with grade clearly marked.

package/skills/steel-rfq/assets/company-profile.example.json

@@ -0,0 +1,7 @@
+{
+  "company_name": "Acme Steel Fabrication",
+  "city_state": "Denver, CO",
+  "payment_terms": "Net 30 from date of delivery",
+  "quote_validity_days": 30,
+  "logo": null
+}

package/skills/steel-takeoff/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: steel-takeoff
+description: >
+  Structural steel takeoff, AISC member lookup, and quantity estimating.
+  Use when performing steel takeoffs, reading structural prints/blueprints,
+  looking up AISC member properties (W-shapes, HSS, angles, channels, pipe),
+  building bills of materials (BOM), calculating steel tonnage, or preparing
+  steel bid packages. Keywords: steel, takeoff, BOM, AISC, W-shape, HSS,
+  angle, channel, weight, tonnage, structural, estimating, blueprint,
+  quantity survey, beam, column, brace, connection, erection, ironwork.
+license: MIT
+compatibility: Requires jq and python3. macOS or Linux.
+metadata:
+  domain: structural-steel
+  version: "1.0.0"
+  aisc-edition: "16th"
+  shapes-count: "400+"
+allowed-tools: Bash Read Edit Write
+---
+
+# Steel Takeoff Skill
+
+Structural steel quantity takeoff and AISC member data lookup using the 16th Edition shapes database.
+
+## Setup (run once per machine)
+
+```bash
+cd "$(dirname "$0")"
+chmod +x scripts/*.sh
+python3 -c "import json, csv, sys" || echo "ERROR: python3 required"
+command -v jq >/dev/null || echo "ERROR: install jq (brew install jq / apt install jq)"
+```
+
+## Quick Reference: AISC Member Lookup
+
+Look up any AISC shape's full property set:
+
+```bash
+# Single member lookup — returns all properties
+./scripts/lookup-member.sh "W14X30"
+
+# Search for W-shapes by minimum moment of inertia
+jq '[.[] | select(.type == "W" and .Ix >= 800)] | sort_by(.weight_per_ft) | .[:5]' assets/aisc-shapes-database.json
+
+# Find lightest W-shape with depth >= 18" and Ix >= 1000 in⁴
+jq '[.[] | select(.type == "W" and .d >= 18 and .Ix >= 1000)] | sort_by(.weight_per_ft) | .[0]' assets/aisc-shapes-database.json
+
+# List all HSS rectangular shapes
+jq '[.[] | select(.type == "HSS-RECT")] | sort_by(.weight_per_ft)' assets/aisc-shapes-database.json
+
+# Find angles with leg >= 4"
+jq '[.[] | select(.type == "L" and .d >= 4)]' assets/aisc-shapes-database.json
+
+# Find channels by weight range
+jq '[.[] | select(.type == "C" and .weight_per_ft >= 15 and .weight_per_ft <= 30)]' assets/aisc-shapes-database.json
+```
+
+## Takeoff Procedure
+
+### Step 1 — Parse Drawings
+Read the structural drawings and extract:
+- Member marks (e.g., B1, B2, C1, G1, BR1)
+- Member sizes (e.g., W14X30, HSS6X6X1/4, L4X4X3/8)
+- Lengths (from grid dimensions or explicit call-outs, use feet-inches: 28'-6")
+- Quantities (count per mark — check symmetry, typical bays, similar conditions)
+- Connection types at each end
+
+### Step 2 — Build the BOM
+For each unique member mark, create a line item:
+
+```bash
+cat assets/bom-template.csv
+```
+
+Fields: Mark, Qty, Size, Grade, Length_ft, Unit_Wt_plf, Total_Wt_lbs, Connections, Notes
+
+### Step 3 — Look Up Unit Weights
+For every member size in the BOM, look up the unit weight from the AISC database:
+
+```bash
+./scripts/lookup-member.sh "W14X30"
+# Output: W14X30 | 30.0 plf | d=13.84" | bf=6.730" | A=8.85 in² | Ix=291 in⁴ | Sx=42.0 in³
+
+./scripts/lookup-member.sh "HSS8X6X1/2"
+# Output: HSS8X6X1/2 | 42.1 plf | d=8.00" | b=6.00" | A=11.7 in² | Ix=96.4 in⁴
+```
+
+### Step 4 — Calculate Totals
+
+```bash
+# From a BOM CSV file
+./scripts/calculate-weight.sh path/to/bom.csv
+
+# Output includes:
+#   Per-line weights
+#   Total weight in lbs and tons
+#   Connection allowance (12%)
+#   Misc steel allowance (5%)
+#   Grand total with estimated cost
+```
+
+### Step 5 — Add Connections & Misc Steel
+See [connection types reference](references/connection-types.md) for standard connection weights.
+
+Rules of thumb for connection allowance:
+| Building Type | Connection % |
+|---|---|
+| Simple warehouse / pre-eng | 8-10% |
+| Standard commercial | 10-12% |
+| Moment frames / complex | 12-18% |
+| Heavy industrial / power | 15-20% |
+
+### Step 6 — Validate
+
+```bash
+python3 scripts/validate-bom.py path/to/bom.csv
+# Checks:
+#   ✓ Valid AISC designations
+#   ✓ Non-zero quantities and lengths
+#   ✓ Correct grade for shape type
+#   ✓ Reasonable weight-per-foot values
+#   ✓ No duplicate marks
+```
+
+## Material Grades Quick Reference
+
+| Grade | Typical Use | Fy (ksi) | Fu (ksi) |
+|---|---|---|---|
+| A992 | W-shapes (default) | 50 | 65 |
+| A500 Gr. B | HSS round | 42 | 58 |
+| A500 Gr. C | HSS rectangular | 50 | 62 |
+| A36 | Angles, channels, plates | 36 | 58 |
+| A572 Gr. 50 | Plates, built-ups | 50 | 65 |
+| A913 Gr. 50/65 | Jumbo shapes | 50/65 | 65/80 |
+| A514 | High-strength plates | 100 | 110-130 |
+| A588 | Weathering steel | 50 | 70 |
+
+Full grade specs: `cat assets/material-grades.json`
+
+## Bolt Reference
+
+| Bolt Type | Grade | Tensile (ksi) | Shear (ksi) | Common Sizes |
+|---|---|---|---|---|
+| A325 / F1852 (TC) | — | 120 | 54/68 | 3/4", 7/8", 1" |
+| A490 / F2280 (TC) | — | 150 | 68/84 | 3/4", 7/8", 1" |
+| A307 | Gr. A | 60 | 24 | 1/2" - 1" |
+
+- N = threads in shear plane (lower capacity)
+- X = threads excluded (higher capacity)
+- SC = slip-critical (higher bolt pretension required)
+
+## Detailed References
+
+For in-depth guidance on specific topics:
+- [AISC Shapes Guide](references/aisc-shapes-guide.md) — all shape families, property definitions, selection guidance
+- [Takeoff Procedures](references/takeoff-procedures.md) — detailed step-by-step with worked examples
+- [Connection Types](references/connection-types.md) — standard connection details, hardware weights, bolt patterns