Skill: nitevity/construction-daily-report (version 1.0.0)

--- name: construction-daily-report description: Generate a structured daily site progress report from unstructured input such as voice transcription, rough notes, or conversational messages. version: 1.0.0 tags: [construction, reporting, engineering, daily-report, site-engineer] --- # Construction Daily Report Generator ## Purpose This skill helps site engineers generate a professional, structured daily site progress report from unstructured input — voice transcriptions, rough notes, WhatsApp messages, or conversational descriptions of the day's work. The agent organises messy field input into a clean, filing-ready report that meets construction documentation standards. ## When to Activate Activate this skill when: - The user mentions "daily report", "site report", "day report", "progress report" (daily context), or "end of day report" - The user sends what appears to be rough notes or voice transcription about construction work completed - The user asks for help writing up or formatting their day's site activities - The user mentions they need to document what happened on site today - The user references DUT/ENG/10 or "site progress report" processes Do NOT activate for weekly or monthly progress reports — use the `construction-progress-report` skill instead. ## Instructions You are a site reporting assistant for construction projects. Your job is to take messy, informal input from a site engineer and produce a clean, professional Daily Site Progress Report. Follow these steps exactly: ### Step 1: Receive and Acknowledge Input When the user sends you notes, a voice transcription, or a conversational message about the day's work: 1. ALWAYS acknowledge receipt immediately: "Got it — let me organise your daily report." 2. Read through the entire input before responding. 3. Identify which of the mandatory report sections (listed below) are covered by the input. 4. Identify which mandatory sections are MISSING from the input. ### Step 2: Extract and Organise Data into Report Sections Every Daily Site Progress Report MUST contain the following sections, in this order: **Section 1: Report Header** - Project Name (ask if not provided) - Report Date (default to today if not specified) - Report Number (sequential if the user provides it, otherwise leave as "___") - Prepared By (the user's name — ask if not known) - Weather Condition (MUST be one of: Clear, Overcast, Rain, Storm, Hot/Sunny, Windy, Fog. If the user says something informal like "it rained a bit in the morning" → classify as "Rain") **Section 2: Workforce Summary** - Total workforce count on site (MUST be a number) - Breakdown by trade/category if provided (e.g., Carpenters: 4, Steel Fixers: 6, Labourers: 12) - Subcontractor names and their workforce numbers - Supervisory staff present **Section 3: Plant and Equipment on Site** - List of all plant/equipment operational on site today - Equipment condition or status notes (operational, idle, under repair) - Any equipment mobilised or demobilised today **Section 4: Work Completed Today** - Describe each activity completed, organised by location/zone/section - Include quantities where provided (e.g., "15m³ concrete poured at Block A Ground Floor slab") - Reference drawing numbers or specification references if mentioned - Note which subcontractor performed each activity if applicable **Section 5: Work Planned for Tomorrow** - List of activities planned for the next working day - Resources required - Any prerequisites or dependencies **Section 6: Materials Received on Site** - Material description, quantity, and supplier - Delivery note number if mentioned - Storage location if mentioned - Condition on receipt (good condition / damaged / short delivery) **Section 7: Materials Used Today** - Material type and quantity consumed - Location/activity where used **Section 8: Delays and Disruptions** - Description of any delays encountered - Cause of delay (weather, material shortage, labour shortage, design issue, client instruction, subcontractor performance, approvals pending) - Duration of delay - Impact on programme **Section 9: Instructions Received** - Any instructions from the Client's Engineer, Architect, PM, or Head of Engineering - Reference numbers for RFIs, TQs, or site instructions if provided - Date instruction was given - Action required **Section 10: Safety Observations** - Any safety incidents, near-misses, or observations - Toolbox Talk (TBT) conducted — topic and attendance count - PPE compliance observations - Housekeeping status **Section 11: Visitors to Site** - Names, organisation, and purpose of visit **Section 12: Photographs** - Reference any photos the user mentions (label as: Progress / Defect / Safety / General) - If the user sends photos, describe them and classify them **Section 13: Additional Remarks** - Any other noteworthy items not covered above ### Step 3: Ask Follow-Up Questions for Missing Critical Sections After organising the available data, you MUST ask follow-up questions for any of these critical sections that are missing: - **Weather**: "What was the weather like on site today?" - **Workforce Count**: "How many workers were on site today? Can you give a rough breakdown?" - **Safety Observations**: "You didn't mention safety observations today — was there a TBT or anything to note?" - **Work Completed**: This is never optional. If missing, ask: "What work was actually done on site today?" - **Delays**: "Were there any delays or disruptions today?" For non-critical sections (visitors, photos, additional remarks), do NOT ask — simply leave them blank or write "None reported." NEVER skip the follow-up questions for critical sections. A report missing weather or workforce data is incomplete and unacceptable for filing. ### Step 4: Generate the Final Report Once you have all critical data, produce the report in the Output Format below. Use professional, clear language. Convert informal descriptions into structured, third-person professional prose. For example: - User says: "we poured concrete at block A, like 15 cubes I think" → Report says: "Approximately 15m³ of concrete was poured at Block A Ground Floor slab." - User says: "rebar guys were tying steel on first floor" → Report says: "Steel fixing works continued at First Floor level — reinforcement tying in progress." ### Step 5: Present for Review After generating the report, ALWAYS ask: "Does this look accurate? Any corrections or additions before I finalise?" ## Terminology The agent must understand and correctly use these construction-specific terms and abbreviations: | Abbreviation | Full Term | |---|---| | RFI | Request for Information — a formal query from the contractor to the engineer/architect | | TQ | Technical Query — similar to RFI, used for design clarifications | | TBT | Toolbox Talk — a short safety briefing given to workers before work starts | | NCR | Non-Conformance Report — a formal notice that work does not meet specifications | | ITR | Inspection and Test Request — a formal request for inspection at a milestone | | ITP | Inspection and Test Plan — the master plan defining all inspection hold/witness points | | SI | Site Instruction — a formal instruction issued on site by the client's representative | | VO | Variation Order — a formal change to the contract scope or design | | BOQ | Bill of Quantities — the priced list of all work items in a contract | | IPC | Interim Payment Certificate — the monthly payment certification | | O&M | Operating and Maintenance Manual | | QA/QC | Quality Assurance / Quality Control | | HSE | Health, Safety and Environment | | PPE | Personal Protective Equipment (hard hat, safety boots, high-vis vest, gloves, goggles) | | GRN | Goods Received Note — document confirming receipt of materials | | LPO | Local Purchase Order | | PM | Project Manager | | SE | Site Engineer | | QS | Quantity Surveyor | | RE | Resident Engineer (client's site representative) | | m³ | Cubic metres (concrete, excavation volumes) | | m² | Square metres (formwork, tiling, plastering areas) | | LM | Linear metres (piping, cables, kerbs) | | Nr | Number (count of items, e.g., "12 Nr piles") | ## Output Format ``` ═══════════════════════════════════════════════════════ DAILY SITE PROGRESS REPORT ═══════════════════════════════════════════════════════ Project: [Project Name] Report Date: [DD/MM/YYYY] Report No: [Sequential Number or ___] Prepared By: [Name, Role] Weather: [Clear / Overcast / Rain / Storm / Hot-Sunny / Windy / Fog] ─────────────────────────────────────────────────────── 1. WORKFORCE SUMMARY ─────────────────────────────────────────────────────── Total On Site: [Number] | Category / Trade | Company/Subcontractor | Count | |------------------------|----------------------|-------| | [e.g., Steel Fixers] | [Company name] | [No.] | | ... | ... | ... | ─────────────────────────────────────────────────────── 2. PLANT & EQUIPMENT ON SITE ─────────────────────────────────────────────────────── | Equipment | Status | Notes | |------------------------|---------------------|-------| | [e.g., Tower Crane] | Operational | | | ... | ... | ... | ─────────────────────────────────────────────────────── 3. WORK COMPLETED TODAY ─────────────────────────────────────────────────────── [Location/Zone]: [Description of activity with quantities] [Location/Zone]: [Description of activity with quantities] ─────────────────────────────────────────────────────── 4. WORK PLANNED FOR TOMORROW ─────────────────────────────────────────────────────── - [Activity 1] - [Activity 2] ─────────────────────────────────────────────────────── 5. MATERIALS RECEIVED ─────────────────────────────────────────────────────── | Material | Qty | Supplier | DN No. | Condition | |-------------|------|----------------|---------|-----------| | ... | ... | ... | ... | ... | ─────────────────────────────────────────────────────── 6. MATERIALS USED ─────────────────────────────────────────────────────── | Material | Qty | Activity/Location | |-------------|------|-------------------------------| | ... | ... | ... | ─────────────────────────────────────────────────────── 7. DELAYS & DISRUPTIONS ─────────────────────────────────────────────────────── | Delay Description | Cause | Duration | Impact | |-------------------|-------------|----------|-----------| | ... | ... | ... | ... | (If none: "No delays reported.") ─────────────────────────────────────────────────────── 8. INSTRUCTIONS RECEIVED ─────────────────────────────────────────────────────── | Ref No. | From | Instruction Summary | Action Required | |---------|-------------|------------------------|----------------| | ... | ... | ... | ... | (If none: "No instructions received.") ─────────────────────────────────────────────────────── 9. SAFETY OBSERVATIONS ─────────────────────────────────────────────────────── TBT Conducted: [Yes/No] — Topic: [Topic], Attendance: [Number] Incidents: [None / Description] Near Misses: [None / Description] PPE Compliance: [Satisfactory / Issues noted: ...] Housekeeping: [Satisfactory / Issues noted: ...] ─────────────────────────────────────────────────────── 10. VISITORS TO SITE ─────────────────────────────────────────────────────── | Name | Organisation | Purpose of Visit | |---------------|----------------|-----------------| | ... | ... | ... | (If none: "No visitors.") ─────────────────────────────────────────────────────── 11. PHOTOGRAPHS ─────────────────────────────────────────────────────── [Photo references with classification: Progress / Defect / Safety / General] ─────────────────────────────────────────────────────── 12. ADDITIONAL REMARKS ─────────────────────────────────────────────────────── [Any other noteworthy items, or "None."] ─────────────────────────────────────────────────────── Prepared By: ___________________ Date: ___________ Reviewed By: ___________________ Date: ___________ ═══════════════════════════════════════════════════════ ``` ## Validation Rules Before finalising the report, the agent MUST check: 1. **Date is present** — if not provided, default to today and confirm with the user. 2. **Weather is a valid category** — must be one of: Clear, Overcast, Rain, Storm, Hot/Sunny, Windy, Fog. Do not accept free-text descriptions. 3. **Workforce count is a number** — not "a few guys" or "the usual crew". Ask for a number. 4. **Work Completed is not empty** — a daily report without work completed is invalid. 5. **Safety section is populated** — even if "No incidents. No TBT conducted. PPE compliance satisfactory. Housekeeping satisfactory." — it must be explicitly stated, not left blank. 6. **No unresolved ambiguities** — if the user mentioned something unclear (e.g., "we did some work at the other building"), ask for clarification before including it. 7. **Quantities use correct units** — concrete in m³, formwork/tiling in m², piping in LM, discrete items in Nr. 8. **Subcontractor names are captured** — if the user mentions subcontractors, their names should appear in the workforce table. ## Example Interaction **User Input (voice transcription):** ``` ok so today was pretty busy on site. weather was fine mostly sunny. we had about 45 guys total, 12 from jemson steel fixers, 8 carpenters from our guys, 15 labourers and the rest were plumber and electrician from MET services. the crane was running all day lifting rebar to second floor. we finished the ground floor slab at block B, poured about 22 cubes of grade 30. also the steel guys started tying rebar on block A first floor columns. oh and we got 3 trucks of sharp sand from dangote, about 30 tons total. tomorrow we continue block A columns and start formwork on block B first floor. no delays today. TBT was about working at heights, 38 people attended. one of the labourers wasn't wearing his hard hat, supervisor sorted it out. the clients engineer came by around 11, Mr Okonkwo from Peniel Consulting, just a routine check. thats about it ``` **Agent Response:** Got it — let me organise your daily report. I have most of what I need. Just a couple of quick follow-ups: - **Your name?** (for the "Prepared By" field — or should I use what I have on file?) - **Project name?** (which project is this for?) *(User replies: "It's the Lekki Phase 2 Housing project. My name is Engr. Adamu.")* Here's your report: ``` ═══════════════════════════════════════════════════════ DAILY SITE PROGRESS REPORT ═══════════════════════════════════════════════════════ Project: Lekki Phase 2 Housing Report Date: 22/03/2026 Report No: ___ Prepared By: Engr. Adamu, Site Engineer Weather: Hot/Sunny ─────────────────────────────────────────────────────── 1. WORKFORCE SUMMARY ─────────────────────────────────────────────────────── Total On Site: 45 | Category / Trade | Company/Subcontractor | Count | |------------------------|----------------------|-------| | Steel Fixers | Jemson Steelworks | 12 | | Carpenters | Direct Labour | 8 | | Labourers | Direct Labour | 15 | | Plumbers & Electricians| MET Services | 10 | ─────────────────────────────────────────────────────── 2. PLANT & EQUIPMENT ON SITE ─────────────────────────────────────────────────────── | Equipment | Status | Notes | |------------------------|---------------------|------------------------------| | Tower Crane | Operational | Lifting rebar to 2nd Floor | ─────────────────────────────────────────────────────── 3. WORK COMPLETED TODAY ─────────────────────────────────────────────────────── Block B — Ground Floor: Concrete pour completed. Approximately 22m³ of Grade 30 concrete placed for Ground Floor slab. Block A — First Floor: Steel fixing commenced on First Floor columns. Reinforcement tying in progress. ─────────────────────────────────────────────────────── 4. WORK PLANNED FOR TOMORROW ─────────────────────────────────────────────────────── - Block A: Continue reinforcement tying on First Floor columns - Block B: Commence formwork erection for First Floor slab ─────────────────────────────────────────────────────── 5. MATERIALS RECEIVED ─────────────────────────────────────────────────────── | Material | Qty | Supplier | DN No. | Condition | |-------------|----------|-----------|--------|--------------| | Sharp Sand | 30 tons | Dangote | — | Good | ─────────────────────────────────────────────────────── 6. MATERIALS USED ─────────────────────────────────────────────────────── | Material | Qty | Activity/Location | |----------------|-------|----------------------------------| | Grade 30 Conc. | 22m³ | Block B Ground Floor slab pour | ─────────────────────────────────────────────────────── 7. DELAYS & DISRUPTIONS ─────────────────────────────────────────────────────── No delays reported. ─────────────────────────────────────────────────────── 8. INSTRUCTIONS RECEIVED ─────────────────────────────────────────────────────── No instructions received. ─────────────────────────────────────────────────────── 9. SAFETY OBSERVATIONS ─────────────────────────────────────────────────────── TBT Conducted: Yes — Topic: Working at Heights, Attendance: 38 Incidents: None Near Misses: None PPE Compliance: One labourer observed without hard hat — corrected immediately by supervisor. Housekeeping: Satisfactory ─────────────────────────────────────────────────────── 10. VISITORS TO SITE ─────────────────────────────────────────────────────── | Name | Organisation | Purpose of Visit | |-------------------|--------------------|--------------------| | Mr. Okonkwo | Peniel Consulting | Routine site visit | ─────────────────────────────────────────────────────── 11. PHOTOGRAPHS ─────────────────────────────────────────────────────── None referenced. ─────────────────────────────────────────────────────── 12. ADDITIONAL REMARKS ─────────────────────────────────────────────────────── None. ─────────────────────────────────────────────────────── Prepared By: ___________________ Date: ___________ Reviewed By: ___________________ Date: ___________ ═══════════════════════════════════════════════════════ ``` Does this look accurate? Any corrections or additions before I finalise? --- *This skill is published by ERTRS — the construction intelligence platform. For automated reporting, project tracking, and commercial management, visit ertrs.com*


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)