Write a site visit report
Turns field or site visit notes into a structured report with observations, evidence, issues rated by severity and owned follow-ups. For consultants, inspectors, auditors and area managers.
A site visit report has two jobs: give someone who was not there an accurate picture of the site, and turn what the visitor found into actions that get done. Readers trust it when every finding is anchored in evidence (what was seen, measured, photographed or shown in a document) and when the report is honest about what was only heard from site staff. It loses value when findings are vague ("housekeeping could be better"), when minor and serious issues sit in one undifferentiated list, when good practice goes unrecorded, and when follow-ups have no owner or date.
Severity scale, applied consistently:
- Critical: immediate risk to people's safety, legal compliance or the core purpose of the site; act now.
- Major: a significant gap against the standard or objective that will cause harm, loss or failure if left; act within an agreed short period.
- Minor: an isolated lapse with limited impact; fix in normal course.
- Observation: not a breach; an improvement opportunity or something to watch.
Write a site visit report for .
- If the notes contain no findings at all, or you cannot tell which site or what the visit was for, ask in one short message and stop.
- Group observations by area or topic in the order a reader would walk the site or follow the purpose of the visit.
- For each observation, record the evidence type: seen, measured, photo (keep the visitor's photo references), document reviewed, or stated by site staff (by role). Keep statements by staff clearly attributed; do not present them as verified. If photos are attached, describe only what is visible in them, cite them by their number or file name, and do not infer readings, dates or causes the image does not show.
- Turn problems into issues. Each issue states the condition found, the standard or expectation it falls short of (only if the notes or purpose name one; otherwise describe the expectation in plain terms and do not cite a regulation or clause that was not given), the impact, and a severity from the scale above. Explain any Critical rating in one line.
- Record what is working well, with the same specificity. Good practice is a finding too and helps the site accept the rest.
- Write follow-ups for every Critical and Major issue and any Minor issue the notes suggest acting on: the action, the owner (role), the due date and how completion will be shown. Use
[need: owner]or[need: date]when the notes do not say. - Write a summary for a reader who reads nothing else: overall impression in one sentence, the number of issues by severity, the most important one or two actions, and any Critical item.
- If anything in the notes points to immediate danger to people, put it first in the summary marked as Critical and say what should happen today.
- Use only what is in the notes. Never invent measurements, names, clause numbers, photos or conversations.
- Neutral, specific language: describe conditions and actions, not people's attitudes. "Two of six fire extinguishers had no inspection tag dated within the last 12 months" rather than "fire safety is sloppy".
- Do not rate an issue Critical or Major without evidence in the notes that supports it; if the severity depends on a fact you lack, give the likely rating and the question that would settle it.
- Match the register to : a client report avoids internal shorthand; a report to the site itself can be more operational.
- Keep the body under about 900 words; put long lists of minor items in a table rather than prose.
Visit report
- Header: site, date, visitor(s), people met (roles), purpose, scope (what was and was not covered).
- Summary: three to five sentences as described in step 7.
- Observations by area: short subsections with bullet findings, each ending with its evidence in brackets.
- Issues: table with # · Area · Issue · Evidence · Severity · Impact.
- Good practice: bullets.
- Follow-ups: table with # · Action · Owner · Due · Evidence of completion.
- Next visit or review: what to check next time, if the notes suggest it.
Questions for the visitor
Bullets: facts you need to confirm, including each [need: …], any severity that depends on a missing fact, and any finding where the notes were ambiguous. "None" if none.
2 required values still a placeholder; the assistant will ask for them.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Writing and communication
- category
- Business writing
- level
- Intermediate
- made for
- Consultant / freelancer, Operations, People manager, Project / program manager
- risk
- read-only
- version
- v1.0.1 · incubating
- reviewed
- 2026-10-03
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-site-visit-report --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-site-visit-report -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-writing-communication@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Business writingWrite a workplace incident report
Writes a factual, blame-neutral report of a workplace accident, near miss, customer, property or security incident, separating observed facts from statements and listing actions with owners.
write-workplace-incident-reportWrite a project status report
Writes a project status report with an evidence-based RAG status, progress, risks, decisions needed and next steps, formatted as an email, a document or a single slide.
write-status-reportWrite an executive summary
Writes an executive summary of a long document that leads with the bottom line, the key points and the ask, using only facts from the source. Use before sending a report to busy readers.
write-executive-summaryWrite an internal announcement
Writes an internal announcement of a reorg, policy change or launch that explains what is changing, why, the impact on each group and where to ask, plus an FAQ and a pre-send check.
write-internal-announcementWrite a project proposal or business case
Writes an internal project proposal or business case covering the problem, options, recommendation, cost, benefits and risks, and marks every missing number instead of inventing it.
write-project-proposalReport writing track
Takes a work report from purpose and audience to an answer-first outline, an evidence check, a full draft, an executive summary and a final edit, pausing for approval between steps.
report-writing-track