meeting-minutes - SKILL.md Agent Skill

name: meeting-minutes description: > Record and generate professional meeting minutes for OAC meetings, progress meetings, safety meetings, and pre-installation conferences. Tracks action items across meetings with automatic carry-forward. Generates .docx minutes documents with status indicators. Integrates with morning brief (overdue action items), weekly report (meeting summary), and daily report (action item references). Surfaces critical action items in handoff reports. Triggers: "meeting notes", "meeting minutes", "OAC meeting", "OAC notes", "progress meeting", "safety meeting", "toolbox talk", "pre-install meeting", "pre-installation conference", "action items", "carry forward", "action item status". version: 1.0.0

Meeting Minutes Skill

Overview

Provides structured meeting recording, action item tracking, and professional .docx generation for construction project meetings. Supports multiple meeting types with specialized content for pre-installation conferences. Automatically carries forward open action items between meetings and surfaces critical items in daily operations.

Meeting Types

OAC Meeting (Owner-Architect-Contractor)

Typically weekly or bi-weekly
Attendees: Owner, Architect, General Contractor, Key Subcontractors
Focus: Overall project status, design decisions, issues, schedule
Content: RFI tracking, change order discussions, coordination
Action items: Design clarifications, schedule updates, specification reviews

Progress Meeting

Weekly or bi-weekly project status
Attendees: General Contractor, Subcontractor Foremen, Key Consultants
Focus: Construction progress, safety, quality, schedule adherence
Content: Daily/weekly progress metrics, upcoming work, resource needs
Action items: Schedule adjustments, material coordination, quality issues

Safety Meeting

Toolbox talks (daily or weekly 15-min safety briefs)
Weekly or monthly formal safety meetings
Attendees: Job site personnel, safety manager, subcontractor leads
Focus: Hazard identification, OSHA compliance, near-miss incidents, safety training
Content: Hazards present, PPE requirements, incident review, corrective actions
Action items: Hazard corrections, training assignments, equipment upgrades

Pre-Installation Conference (Pre-Install)

Held before major trades begin (concrete, MEP, structural, etc.)
Attendees: Trade contractor, General Contractor, Architect, Inspector
Focus: Spec compliance, material quality, installation procedures, QC checkpoints
Content: Spec section review, submittal status, delivery schedules, QC requirements, hold points
Action items: Material ordering, submittal finalization, equipment staging, coordination tasks
Special fields: spec_sections_reviewed[], submittal_status[], material_delivery_dates[], qc_requirements[], weather_restrictions, hold_points[]

Coordination Meeting

Trades coordination, safety coordination, logistics
Attendees: Multiple subcontractors, General Contractor, Scheduler
Focus: Trade sequencing, spatial coordination, utility routing, equipment staging
Content: Weekly work plans, interface coordination, access requirements, phasing
Action items: Coordination requirements, schedule adjustments, equipment staging

Core Data Structures

Meeting Object

{
  id: "MTG-001",                           # Auto-assigned, sequential, never reset
  type: "OAC" | "progress" | "safety" | "pre-install" | "coordination",
  date: "2025-02-17",                      # ISO 8601 format
  time: "09:00 AM",                        # 12-hour format with AM/PM
  location: "Project Trailer" | "Site Office",
  attendees: [
    {
      name: "John Smith",
      company: "ABC Construction",
      role: "Project Manager",
      phone: "555-0101",
      email: "john@abcconstruction.com"
    },
    ...
  ],
  discussion_items: [
    {
      topic: "Schedule Updates",
      discussion_summary: "Team reviewed current critical path...",
      decisions_made: ["Adjust concrete pour by 3 days", "Expedite rebar delivery"],
      linked_action_items: ["AI-0001", "AI-0002"]
    },
    ...
  ],
  action_items: ["AI-0001", "AI-0002", ...],        # References to action item IDs
  carry_forward_items: ["AI-0045", "AI-0046", ...], # From previous meetings
  previous_meeting_id: "MTG-015" | null,
  prepared_by: "Jane Doe",
  prepared_date: "2025-02-17",
  general_notes: "Weather delay expected next week"
}

Action Item Object

{
  id: "AI-0001",                           # Auto-assigned, sequential, never reset
  description: "Review final mechanical submittal and approve",
  assignee: "Tom Jones",
  assignee_company: "XYZ MEP",
  due_date: "2025-02-24",
  status: "open" | "in_progress" | "closed" | "deferred",
  linked_rfi: "RFI-018" | null,
  linked_co: "CO-005" | null,
  linked_submittal: "SUB-M-042" | null,
  created_meeting: "MTG-001",
  closed_meeting: null,
  notes: "Client awaiting architect review",
  created_date: "2025-02-17"
}

Meeting Log (Project-Level)

{
  project_id: "PRJ-2024-001",
  meetings: [
    { Meeting Object },
    { Meeting Object },
    ...
  ],
  last_meeting_date: "2025-02-17"
}

Action Item Log (Project-Level)

{
  project_id: "PRJ-2024-001",
  items: [
    { Action Item Object },
    { Action Item Object },
    ...
  ],
  open_count: 23,
  overdue_count: 3,
  closed_count: 145
}

Carry-Forward Logic

Automatic Carry-Forward

When creating a new meeting:

Load all action items with status in ["open", "in_progress"]
Filter by created_meeting <= previous_meeting_id
Present to user with context: due date, assignee, description
For each item, ask: "Still open? (yes/no/deferred/completed)"
If completed: update status = "closed", closed_meeting = current meeting_id
If deferred: capture new due date and notes
If still open: capture status update in notes
Store updated items in action_item_log
Link carry-forward items to current meeting via carry_forward_items[]

Overdue Item Highlighting

Any action item with due_date < today AND status in ["open", "in_progress"]
Flagged with visual indicator (red, bold)
Surfaced in morning brief automatically
Requires status update or new due date during meeting

.docx Generation

Document Header

Project name and code (top-left)
Meeting type and ID centered, prominent
Date, time, location (top-right aligned)
Prepared by and date prepared (footer)

Attendees Section

Professional table: Name | Company | Role | Contact
All attendees listed in attendance order

Discussion Items Section

For each discussion_item:
- Large bold topic heading (navy color)
- Discussion summary paragraph
- "Decisions" subheading (blue)
- Bullet list of decisions_made
- Action items from this topic linked by ID

Action Items Table

Columns: ID | Description | Assignee | Due Date | Status
Rows sorted by due date (soonest first)
Status color coding:
- Open: Red background, white text
- In Progress: Yellow background, black text
- Closed: Green background, white text
- Deferred: Gray background, white text
Bold action items overdue (due_date < today)
Carry-forward items marked with "CF" badge

Carry-Forward Summary (if applicable)

Heading: "Items Carried From Previous Meeting"
Count of carried items, count closed, count still open
Summary line: "3 of 5 carry-forward items closed this meeting"

Pre-Installation Conference Special Content

If meeting type == "pre-install":

Spec Sections Reviewed: bulleted list
Submittal Status Table: Submittal ID | Item | Status | Due Date
Material Delivery Schedule: Item | Supplier | Expected Date
QC Requirements: bullet list of quality checkpoints
Weather Restrictions: paragraph on weather-dependent work
Hold Points: numbered list of inspection hold points

General Notes Section

Any additional meeting notes
Attendee absences or late arrivals
Next meeting schedule

Styling

Font: Calibri 11pt (body), 14pt bold (section headings)
Header color: Navy (#001a4d)
Accent color: Blue (#0047ab)
Zebra striping on tables (alternating light gray rows)
Page breaks between major sections
Footer with page numbers and "Confidential - Project Document"

Integration Points

Morning Brief Integration

/morning-brief surfaces:
  - Overdue action items (due_date < today AND status in [open, in_progress])
  - High-priority open items from most recent OAC meeting
  - Any deferred items with new due dates
  - Display format: "2 overdue action items require status update"

Weekly Report Integration

/weekly-report includes:
  - Count of meetings held that week
  - Summary of meeting types
  - New action items created
  - Action items closed
  - Overdue count at week end
  - Critical decisions made (from OAC meetings)
  - Format: Executive summary section, detailed table

Daily Report Integration

/daily-report can reference:
  - Due today action items
  - Upcoming critical milestones
  - Links to related meeting minutes
  - Format: "Action items due today" section

Project Handoff Integration

Transition reports include:
  - All open action items (sorted by due date)
  - Deferred items with rationale
  - Critical carry-forward items for next phase
  - Meeting schedule cadence established

Storage Locations

Document Output

folder_mapping.oac_reports / "meeting_minutes" / "meeting_minutes_MTG-001_2025-02-17_OAC.docx"

Structured Data

meeting-log.json → meetings[]          → All meetings, indexed by meeting_id
meeting-log.json → action_items[]      → All action items, indexed by action_id
meeting-log.json → last_meeting_date   → Date of most recent meeting

Workflow Summary

Meeting recorded via /meeting-notes command
Carry-forward items automatically surface from previous meeting
Action items created with ID, assignee, due date
.docx minutes generated with professional formatting
Morning brief surfaces overdue items daily
Weekly report summarizes meeting activity and action items
Daily report calls out items due today
Status updates during next meeting (carry-forward logic)
Items closed when completed, tracked in closed_meeting field

Key Fields Explained

meeting_id (MTG-001): Sequential, auto-assigned, never reset. Provides unique identifier for all meetings across project lifecycle.
action_id (AI-0001): Sequential, auto-assigned, never reset. Provides unique identifier for all action items. Used for cross-referencing in RFIs, COs, etc.
status: Tracks action item lifecycle. "open" = assigned but not started, "in_progress" = actively being worked, "closed" = completed, "deferred" = pushed to future date.
created_meeting / closed_meeting: Tracks which meeting created/closed the item. Enables historical reporting.
carry_forward_items[]: Explicit list of items carried from previous meeting. Differentiates carry-forward from newly created items.
linked_rfi / linked_co / linked_submittal: Cross-references to related project documents. Enables quick navigation from meeting minutes to RFI/CO/submittal tracking.

Project Intelligence Auto-Population

When project intelligence is loaded, auto-populate meeting agenda sections with current project data to save time and ensure accuracy.

Schedule Update Section

Before or during progress/OAC meetings:

Read schedule.json → current_phase, percent_complete, milestones[]
Auto-populate schedule status: current phase, overall % complete, upcoming milestones (next 30 days), any milestones at risk
Read schedule.json → critical_path[] → list critical path activities and their status
Example: "Schedule Status: Foundation phase, 22% complete. Upcoming: Steel delivery 3/1, PEMB erection start 3/8."

RFI/Submittal Status Tables

For OAC and progress meetings:

Read rfi-log.json → count RFIs by status (open, overdue >14 days, resolved this week)
Read submittal-log.json → count submittals by status (pending review, overdue >10 days, approved this week)
Auto-populate status tables with counts and highlight overdue items
Example: "RFIs: 3 open (1 overdue >14 days), 2 resolved this week. Submittals: 5 under review (1 overdue), 3 approved."

Change Order Status

For OAC meetings:

Read change-order-log.json → group COs by status (draft, submitted, under_review, approved)
Auto-populate CO section with pending CO count, total pending cost exposure, recently approved COs
Example: "Change Orders: 2 pending review ($23,500 exposure), 1 approved this week (CO-005, $17,800)."

Action Item Carry-Forward

For all meeting types:

Read meeting-log.json → pull all action items where status != "closed" from previous meetings
Auto-populate carry-forward section with item ID, description, assignee, due date, and days overdue
Calculate aging: items open >14 days highlighted, items open >30 days flagged critical
Example: "5 carry-forward items (2 overdue): AI-0045 — Review MEP coordination (Tom Jones, 8 days overdue)"

Weather Summary

For progress meetings:

Read daily-report-data.json → pull weather data from all reports in the meeting period
Summarize: average temp range, precipitation days, any weather delays
Example: "Weather this week: Highs 42-55°F, lows 28-35°F. 1 rain day (Tuesday). No weather delays."

Safety Summary

For all meeting types (safety moment section):

Read safety-log.json → pull incident count, near-miss count for the period
Calculate TRIR from osha_300_log if available
Read safety-log.json → toolbox_talks[] → count talks held this period
Example: "Safety: 0 recordable incidents, 3 near-misses reported, 5 toolbox talks held. TRIR: 0.0 YTD."

Trigger Phrases

The skill activates on phrases like:

"Take meeting minutes"
"Record meeting notes"
"OAC meeting notes"
"What are our open action items?"
"Follow up on this action item"
"Carry forward items from last meeting"
"Generate meeting report"
"Pre-install conference"
"Safety toolbox talk"