observation-analysis

Plan and conduct observation sessions to discover unstated requirements from real user workflows.

23|1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/jdm4pku/RE-Skills --skill observation-analysis-jdm4pku
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: observation-analysis
Source: https://github.com/jdm4pku/RE-Skills/tree/main/skills/observation-analysis
Command: npx skills add https://github.com/jdm4pku/RE-Skills --skill observation-analysis-jdm4pku

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interviews alone miss tacit knowledge, workarounds, and workflow inefficiencies because users cannot accurately describe their own routines. This Skill guides you through planning and conducting observation sessions (job shadowing and contextual inquiry) to uncover the unstated requirements hiding in the gap between what users say and what they actually do. ## Core Features & Use Cases - Session Planning & Execution: Step-by-step guidance for choosing active vs. passive observation, selecting participants, and recording timestamped observation logs. - POET Framework: Systematically capture People, Objects, Environment, and Tasks so no dimension of the work context is missed. - Requirement Extraction: Convert workarounds, pain points, delays, errors, and handoffs into candidate requirements with traceable observation sources. - Use Case: Before designing a chemical inventory system, observe a lab technician processing a shipment, discover she walks to another room three times per session and tracks hazard classes on sticky notes, then convert those findings into requirements for mobile data entry and a hazard classification field. ## Quick Start Ask the agent to plan an observation session for a specific workflow using the observation-analysis skill and its session template.

Frequently Asked Questions about observation-analysis

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

FAQPage Schema
How do I conduct an observation session for requirements gathering?▼

Define the process scope, select 2-3 participants at different experience levels, and schedule during real work rather than staged demos. Record timestamped actions, artifacts, and signals like workarounds or delays, then validate findings with participants within 48 hours.

What is the difference between active and passive observation in requirements elicitation?▼

Passive observation (job shadowing) means watching silently and asking questions afterward, minimizing disruption to natural behavior. Active observation (contextual inquiry) involves asking questions during the task, giving deeper insight but potentially altering the workflow.

How do I turn observation findings into software requirements?▼

Review notes for patterns like workarounds, pain points, delays, errors, and handoffs, each of which signals an implied gap. Draft a candidate requirement per finding with the observation source recorded, then refine it using a requirements-writing skill.

Why do users behave differently when being observed at work?▼

This is the Hawthorne effect: people perform the ideal process instead of the real one when watched. Counter it by observing longer than 15-20 minutes, running multiple sessions, and comparing observations against error or defect data.

When should I use observation instead of stakeholder interviews?▼

Use observation when interview data conflicts with defect data, when stakeholders claim a process works fine despite high error rates, or when you need to understand physical environment constraints. Interviews reveal what people think they do; observation reveals what they actually do.