costx-nrm2-boq
Prepare a complete RICS NRM2 Bill of Quantities as a RIB CostX workbook, covering header, Substructure / Superstructure-by-floor / External Works structure, NRM2 work-section items, quantities live-linked to model dimension groups (XGETAREA, XGETLENGTH, XGETVOLUME, XGETCOUNT), derived finishes and professional formatting. Use after model mapping, or whenever a CostX BOQ to NRM2 is needed.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/ahnaf-salaahi--costx-nrm2-boq-skill)HTML
<a href="/listings/ahnaf-salaahi--costx-nrm2-boq-skill"><img src="/api/listings/ahnaf-salaahi--costx-nrm2-boq-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Claude app (claude.ai / desktop)
1. **Code → Download ZIP** on this repo. 2. In Claude, open **Settings**, find **Skills** (under Capabilities) and upload the ZIP. 3. Ask: *"Use the costx-nrm2-boq skill to prepare my NRM2 BOQ in CostX."*
Claude Code
git clone https://github.com/ahnaf-salaahi/costx-nrm2-boq-skill ~/.claude/skills/costx-nrm2-boq
---
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 · 168 lines
- ---
- name: costx-nrm2-boq
- description: Prepare a complete RICS NRM2 Bill of Quantities as a RIB CostX workbook, covering header, Substructure / Superstructure-by-floor / External Works structure, NRM2 work-section items, quantities live-linked to model dimension groups (XGETAREA, XGETLENGTH, XGETVOLUME, XGETCOUNT), derived finishes and professional formatting. Use after model mapping, or whenever a CostX BOQ to NRM2 is needed.
- ---
- # CostX NRM2 BOQ preparation (workbook)
- Builds a formatted NRM2 Bill of Quantities in a CostX workbook with every model quantity
- **live-linked** to dimension groups, so the BOQ updates when the model changes. Tested in
- **CostX 7.1** on a 2-storey project (128 BOQ rows, 70+ linked quantities, all verified).
- Prerequisite: dimension groups imported from a model (see the **costx-model-mapping** skill)
- or measured manually in CostX.
- ---
- ## 0. Gather before building
- 1. **Header details**: module code and name, coursework or project title, group or company,
- standard (NRM2).
- 2. **Dimension group names**: expand the Dimension Groups panel. Groups that share a name
- carry a suffix, e.g. `Wall - 115mm brick/block partition (3 SUPERSTRUCTURE\L2\14 MASONRY)`.
- To read any exact name, drag the group onto a quantity cell; the dialog's
- **Text To Be Inserted** box shows it. Press Esc to cancel.
- 3. **Hover each group** to see which values it carries (Count, Length, Area, Volume). You
- can link any of them.
- 4. Decide the **BOQ structure** (default below). Ask the user if they have a required format.
- ## 1. Create the workbook
- Workbooks ribbon → **Add** → *Workbook Properties*:
- - **Name**: e.g. `QS4100 BOQ - Group D2 (NRM2)`
- - **Notes**: project and assignment details and the measurement basis
- - **Insert**
- 
- The Cost sheet columns are **A Code | B Description | C Quantity | D Unit | E Rate |
- F Subtotal | G Factor | H Total**. Quantity, Subtotal and Total are the shaded columns.
- ## 2. Enter the BOQ structure in one paste
- Select **A1** and paste (or type) tab-separated rows: `Code<TAB>Description<TAB>Qty<TAB>Unit`.
- Newlines start new rows. A full NRM2 template is in `templates/nrm2_boq_template.tsv`.
- Rules learned in practice:
- - **The display can lag** after a large paste and may look empty. Press **Ctrl+End** to
- confirm the last row before pasting again; otherwise you paste twice.
- - **Don't use the cell-reference box** (top left, e.g. `A1`) to jump. Typing in it wrote
- the text into the active cell. Navigate with **Ctrl+Home** and the arrow keys.
- - Leave the Quantity column empty in the paste; it gets formulas next.
- - Blank spacer rows: use a single space in A and B.
- Default structure (NRM2):
- ```
- Title block (rows 1-4): module, coursework, BOQ - group, measurement basis
- PART 1 PRELIMINARIES
- PART 2 SUBSTRUCTURE WS5, WS11, WS14, WS19
- PART 3 SUPERSTRUCTURE
- 3.1 GROUND FLOOR (L1) WS11, WS14, WS20, WS23, WS24, WS25, WS28, WS29, WS32
- 3.2 FIRST FLOOR (L2) same work sections
- 3.3 ROOF (L3) WS16, WS18, WS33
- PART 4 EXTERNAL WORKS WS34, WS35
- PART 5 SERVICES (PROVISIONAL) WS38, WS39
- NOTES
- ```
- Item codes: `part/worksection.item`, e.g. `2/11.2` (substructure concrete) and `3.2/14.1`
- (first-floor masonry). See `references/nrm2-items.md` for descriptions, units and rules.
- ## 3. Link quantities to dimension groups
- ### Method A: drag and drop (good for the first few, and to learn names)
- Drag a group from the Dimension Groups panel onto the item's **Quantity** cell →
- *Add Quantity* dialog:
- 
- - **Quantity Type**: pick which value (Area / Length / Volume / Count). Click the box, then
- **Alt+Down** opens the list with the live values for every field.
- - **Rounding**: 2 decimal places. **Display decimals**: 2.
- - **Live Quantity Link**: ticked.
- - **Enter** = Update (inserts the formula).
- 
- ### Method B: type the formula (fastest, and exact)
- | Function | Returns |
- |---|---|
- | `=XGETAREA("group name",2)` | Area |
- | `=XGETLENGTH("group name",2)` | Length |
- | `=XGETVOLUME("group name",2)` | Volume |
- | `=XGETCOUNT("group name",2)` | Count (nr) |
- The `2` is the rounding. Formulas can be added and multiplied, and can refer to other cells:
- ```
- =XGETAREA("Wall - 115mm brick/block partition",2)+XGETAREA("Wall - 115mm brick/block partition (3 SUPERSTRUCTURE\L1\14 MASONRY)",2)
- =2*C40 plaster to both faces of partitions
- =C60+C61 emulsion = plaster to external walls + partitions
- ```
- Linked results appear in **green**.
- ### One group feeds several items (use the right value)
- | Group | BOQ items |
- |---|---|
- | Ground slab | Concrete (Volume) · Hardcore, Compaction, DPM, Fabric (Area) · Edge formwork (Length) |
- | Suspended slab | Concrete (Volume) · Soffit formwork (Area) · Edge formwork (Length) |
- | External wall | Masonry (Area) · DPC (Length, ground floor) · Internal plaster (=Area) · Render (=Area) · Paint |
- | Partition | Masonry (Area) · DPC (Length) · Plaster both faces (=2×Area) · Paint |
- | Ceiling | Lining (Area) · Ceiling paint (=Area) |
- | Rooms | Screed / floor finish (Area) · Skirting (Length) |
- | Railings | Balustrade / handrail (Length) |
- ### Items the model can't provide
- Leave Quantity blank (or measure in CostX 2D) for: excavation, disposal, backfilling,
- foundation concrete, columns, beams, reinforcement, roof structure, hips/ridges, fascia,
- rainwater goods, drainage, other sanitary fittings, services. Trench items can use the
- ground-floor wall **Length** as the trench centre line, e.g.
- `=XGETLENGTH("Wall - 230mm common brickwork, external",2)*0.6*0.9` for excavation, with the
- width and depth stated in the description.
- 
- ### ⚠️ Reliability rules (AI agent / computer use)
- - Commit each formula with **Enter** before the next one, and wait about 1 s between pastes.
- Another app using the clipboard at the same moment once dropped stray text into cells.
- - After every batch, screenshot and **check each value** against the dimension group.
- - If the dialog opens on the wrong row, press Esc. The Escape key is safe.
- - Keyboard focus can jump back to the agent's own window; click a grid cell before typing.
- ## 4. Format the BOQ
- | Task | How (CostX 7) |
- |---|---|
- | Select a column range | Ctrl+Home → arrows to the column → **Shift+Down** to the last row. Clicking the column header does **not** select it. |
- | 2 decimal places | Select C1:C(last) → **Increase decimal places** button (Workbooks → Format) twice. |
- | Whole numbers for "nr" | Select the count rows → **Decrease decimal places** twice. |
- | Bold headings | Select A:B on each PART / sub-part / WS row → **Ctrl+B**. |
- | Title | Select A1:B3 → font size box → `11` → Enter. |
- | Centre units | Select D1:D(last) → Centre button. |
- | Column widths | Drag the header borders (Code ≈ 90 px, Description ≈ 460 px). Rows shrink to one line once descriptions fit. |
- | Notes block | Last rows: basis of measurement, which items are linked, manual items, NRM2 notes (e.g. voids ≤ 0.50 m² not deducted). |
- 
- 
- ## 5. Rates and totals (optional)
- Enter rates in **E Rate**. CostX calculates Subtotal / Total per row, and the workbook
- total shows at the top right (*Total =*). Rates can come from a Rate Library (Workbook
- Properties → Default Rate Library) or be typed in.
- ## 6. Verification checklist
- - [ ] Every model-derived item has a green linked value; spot-check against the group tooltips.
- - [ ] Per-floor values add up to the model totals (e.g. L1 + L2 walls = total wall area).
- - [ ] No stray text in the Quantity column (scroll the whole sheet).
- - [ ] Units match NRM2 (m, m², m³, nr, t, item).
- - [ ] Header shows module, coursework title, group and NRM2.
- - [ ] Manual items are listed in the Notes.
- ## 7. Troubleshooting
- | Symptom | Fix |
- |---|---|
- | Formula returns 0 / error | Group name doesn't match exactly (check the suffix). Get it from the drag-and-drop dialog. |
- | Big paste "did nothing" | It did; the display lagged. Ctrl+End to check, and don't paste twice. |
- | Text typed into the wrong cell | You used the cell-reference box. Use Ctrl+Home + arrows. |
- | Decimals didn't change | The column header click didn't select. Select with Shift+arrows. |
- | Value shows whole number but should be decimal | Display decimals set to 0 in the dialog. Fix with the increase-decimals button. |
- | Quantities wrong after model update | Re-import groups (see model-mapping skill), then **Recalculate Workbook**. |
README.md · README · 125 lines
- # CostX NRM2 BOQ: a Claude skill
- **Build a complete, formatted RICS NRM2 Bill of Quantities in a RIB CostX workbook, with every model quantity live-linked to dimension groups.**
- This is a [Claude skill](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview).
- It works two ways:
- - **With Claude** (Claude app, Claude Code, or Claude with computer use): install it and Claude builds
- the workbook for you: header, NRM2 structure, linked quantities, derived finishes and formatting.
- - **Without Claude**: [`SKILL.md`](SKILL.md) is a complete manual you can follow yourself.
- Tested in **RIB CostX 7.1** on a real 2-storey project: 128 BOQ rows and 70+ linked
- quantities, each checked against an independent take-off.
- Companion skill → **[costx-model-mapping-skill](https://github.com/ahnaf-salaahi/costx-model-mapping-skill)**
- (creates the dimension groups this BOQ links to).
- ---
- ## What you get
- | | |
- |---|---|
- | `SKILL.md` | The skill: workbook setup → NRM2 structure → linking → derived items → formatting → checks |
- | `templates/nrm2_boq_template.tsv` | 128-row NRM2 BOQ (Substructure / Superstructure by floor / Roof / External Works / Services), pasteable into CostX |
- | `templates/linked_formulas_example.md` | Every linked formula from the test project, with results |
- | `references/nrm2-items.md` | NRM2 work sections, units, key rules, which model value feeds which item, backfill maths |
- ## Result
- 
- ```
- QS4100 BUILDING INFORMATION MODELLING AND MANAGEMENT
- CW COURSEWORK: COLLABORATIVE PROJECT DELIVERY THROUGH BIM INTEGRATION
- GROUP BILL OF QUANTITIES – GROUP D2
- PART 2 SUBSTRUCTURE WS5 · WS11 · WS14 · WS19
- PART 3 SUPERSTRUCTURE
- 3.1 GROUND FLOOR (L1) WS11 · WS14 · WS20 · WS23 · WS24 · WS25 · WS28 · WS29 · WS32
- 3.2 FIRST FLOOR (L2) …
- 3.3 ROOF (L3) WS16 · WS18 · WS33
- PART 4 EXTERNAL WORKS WS34 · WS35
- ```
- ---
- ## Install
- ### Claude app (claude.ai / desktop)
- 1. **Code → Download ZIP** on this repo.
- 2. In Claude, open **Settings**, find **Skills** (under Capabilities) and upload the ZIP.
- 3. Ask: *"Use the costx-nrm2-boq skill to prepare my NRM2 BOQ in CostX."*
- ### Claude Code
- ```bash
- git clone https://github.com/ahnaf-salaahi/costx-nrm2-boq-skill ~/.claude/skills/costx-nrm2-boq
- ```
- ---
- ## Walkthrough (screenshots)
- ### 1. Create the workbook
- Workbooks → **Add**, then give it a name and notes (assignment or project details).
- | Workbook Properties | Name and notes |
- |---|---|
- |  |  |
- ### 2. Paste the NRM2 structure
- Select A1 and paste `templates/nrm2_boq_template.tsv`. If the screen looks empty, press
- **Ctrl+End**; a big paste can take a moment to show.
- ### 3. Link quantities
- Drag a dimension group onto a Quantity cell. Choose the value (Area / Length / Volume /
- Count) and 2 decimals; CostX inserts a live formula such as `=XGETAREA("2.5.1 Site clearance",2)`.
- 
- **Alt+Down** on *Quantity Type* lists every value the group carries. Here the ground slab
- gives Area (hardcore, DPM), Length (edge formwork) and Volume (concrete):
- 
- Or type formulas directly (fastest):
- ```
- =XGETVOLUME("RC slab 150mm - L1",2)
- =XGETLENGTH("Wall - 230mm common brickwork, external",2) DPC
- =XGETAREA("Wall - 115mm brick/block partition",2)+XGETAREA("Wall - 115mm brick/block partition (3 SUPERSTRUCTURE\L1\14 MASONRY)",2)
- =2*C40 plaster to both faces
- ```
- 
- ### 4. Format
- Bold headings (Ctrl+B), a larger title, 2 decimals (whole numbers for nr), centred units
- and a notes block.
- 
- 
- ---
- ## Key lessons (what goes wrong)
- - **Group names must match exactly**, including suffixes such as `(3 SUPERSTRUCTURE\L2\14 MASONRY)`.
- Drag a group onto a cell and read the *Text To Be Inserted* box to get the name.
- - **Don't navigate with the cell-reference box**; it types into the cell. Use Ctrl+Home + arrows.
- - **Clicking a column header doesn't select the column** for formatting. Use Shift+arrows.
- - **One dimension group feeds many items** (e.g. the slab gives concrete, hardcore, DPM,
- fabric and edge formwork). Pick the right value type.
- - **Unmodelled work** (foundations, excavation, backfill, frame, rebar, drainage, services)
- is measured manually. The template keeps those rows ready, and `references/nrm2-items.md`
- gives the backfill and compaction formulas.
- ## Limitations
- - Tested on CostX 7.1. Ribbon names may differ in other versions.
- - The NRM2 summary is a working aid; check items against your copy of NRM2 and your
- course or company format.
- ## Credits
- Created by **Ahnaf Salaahi** ([ahnaf-salaahi](https://github.com/ahnaf-salaahi)), BSc (Hons) Quantity
- Surveying, University of Moratuwa, developed during the QS4100 Building Information
- Modelling and Management coursework (Group D2), written with Claude.
- MIT License.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.