Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ahnaf-salaahi--costx-nrm2-boq-skill/badge.svg)](/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

i

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.