quarters-inspection

Inspect staff quarters photos against inventory and checklist packs to produce pass/fail reports.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill quarters-inspection-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quarters-inspection
Source: https://github.com/tapway/shogun-os/tree/main/skills/facilities/quarters-inspection
Command: npx skills add https://github.com/tapway/shogun-os --skill quarters-inspection-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Facility and plantation managers need a consistent way to verify staff quarters conditions without manual walkthroughs. This Skill turns photos submitted via Telegram or a web portal into structured pass/fail inspection reports checked against a defined inventory and checklist pack. ## Core Features & Use Cases - Pack-driven VLM inspection: Builds a vision-model prompt from a JSON/YAML inspection pack (expected furniture counts plus cleanliness and safety checklist items) and parses the VLM's JSON response. - Deterministic report building: Converts observations into a validated report with per-item pass/fail, a failed_items list, and an overall status, rendered as Markdown. - Fail-closed safety policy: Checklist items the VLM could not assess default to fail, so safety-critical checks like mold or wiring are never silently skipped. - Use Case: A plantation supervisor sends inspect SITE-A UNIT-12 plantation-type-a-v1 with three room photos via Telegram and receives a report flagging a missing cupboard and mold near the window. ## Quick Start Send the inspect command with a site ID, unit ID, and pack ID along with photos of the quarters to receive a structured pass/fail inspection report.

Frequently Asked Questions about quarters-inspection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I inspect staff quarters from photos using a checklist?

Send the command `inspect <site_id> <unit_id> [pack_id]` with photo attachments via Telegram, or call the web portal assess endpoint. The skill builds a VLM prompt from your inspection pack, parses the JSON observations, and returns a pass/fail report.

What is an inspection pack and how do I create one?

An inspection pack is a JSON or YAML file defining expected inventory items with counts and a checklist of conditions with category and severity. Validate it with the validate_pack.py script before use; if no pack is supplied, default rubrics from the atomic skills are used.

Does the quarters inspection work without photos?

No, the inspection requires JPEG or PNG photos because it relies on a vision language model such as Qwen-VL to observe inventory and conditions. Text-only submissions cannot be assessed.

Why did a checklist item fail when it was not visible in the photo?

The skill uses a fail-closed policy: checklist items the VLM could not assess default to fail. This is intentional for safety-critical checks like mold or wiring, flagging them for manual follow-up instead of silently passing.

Can the inspection skill identify residents or create work orders?

No, resident identity and face recognition are explicitly out of scope, and version 1 only produces reports without auto-creating maintenance work orders. Failed items must be actioned manually.