본문으로 건너뛰기
cccskills
무료GitHub에 공개

observe-guidance

Guide a person in systematic observation of systems, patterns, or phenomena. AI coaches neutral attention, field notes methodology, pattern recognition, hypothesis formation, and structured reporting for debugging, research, and system understanding. Use when a person wants to understand a system's behavior before intervening, when someone keeps jumping to conclusions and needs the discipline of observation first, when preparing an evidence-based report, or when studying team dynamics or process effectiveness through direct observation.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md14.5 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Observe (Guidance)

Guide a person in systematic observation of a system, phenomenon, or pattern. The AI acts as a field study coach — helping frame the observation target, prepare a protocol, sustain neutral attention, record findings with field notes, analyze patterns, and report observations with clear separation of data and interpretation.

When to Use

  • A person wants to understand a system's behavior before intervening (debugging by observation rather than by trial and error)
  • Someone is conducting research or gathering evidence and needs structured observation methodology
  • A person keeps jumping to conclusions and needs to develop the discipline of observation before interpretation
  • Someone is preparing a report that requires evidence-based findings, not opinions
  • A person wants to understand team dynamics, user behavior, or process effectiveness through direct observation
  • After meditate-guidance has cultivated sustained attention, the person wants to direct that attention toward a specific system

Inputs

  • Required: What the person wants to observe (a system, process, behavior, codebase, team dynamic, natural phenomenon)
  • Required: Why they are observing (debugging, research, audit, curiosity, improvement)
  • Optional: Time available for observation (single session vs. multi-day study)
  • Optional: Prior attempts to understand the system (what has already been tried)
  • Optional: Specific questions or hypotheses they want to test
  • Optional: Tools available for recording (notebook, screen capture, logging, metrics)

Procedure

Step 1: Frame — Define the Observation Target

Help the person set up a clear, bounded observation frame.

  1. Ask what they want to observe: "What system or behavior are you trying to understand?"
  2. Help them narrow the scope: "What specific aspect of that system interests you most?"
  3. Identify the observation purpose: understanding, debugging, improvement, evidence-gathering, or pure curiosity
  4. Set boundaries: what is in scope and what is not (prevents observation from expanding endlessly)
  5. If they have a hypothesis: state it explicitly, then set it aside — "We will look for evidence both for and against this"
  6. Choose the observation stance:
    • Naturalist: observe without interfering (best for understanding behavior)
    • Controlled: change one variable and observe the effect (best for debugging)
    • Longitudinal: observe over time (best for detecting trends)

Expected: A clear observation frame with defined target, scope, purpose, and stance. The person knows what they are looking at and what they are not looking at.

On failure: If the person cannot narrow their focus ("I want to understand everything"), help them pick one entry point: "What is the one behavior you find most confusing?" If they are already committed to a conclusion ("I just need to prove X"), gently challenge: "What would we need to see to disprove that? Let's look for both."

Step 2: Prepare — Set Up the Observation Protocol

Help the person establish a systematic approach to recording what they observe.

  1. Choose the recording method based on the observation type:
    • Codebase/system: file paths, line numbers, timestamps, log entries
    • Behavior/process: time-stamped notes with actor, action, and context
    • Team/communication: quotes, speaker identifiers, non-verbal cues
    • Natural/physical: sketches, measurements, environmental conditions
  2. Create a simple recording template:
Field Notes Template:
┌─────────────┬────────────────────────────────────────────────────────┐
│ Timestamp   │ When the observation occurred                          │
├─────────────┼────────────────────────────────────────────────────────┤
│ Observation │ What was seen/heard/measured (fact only)               │
├─────────────┼────────────────────────────────────────────────────────┤
│ Context     │ What was happening around the observation              │
├─────────────┼────────────────────────────────────────────────────────┤
│ Reaction    │ Observer's response (thoughts, emotions, surprises)    │
├─────────────┼────────────────────────────────────────────────────────┤
│ Hypothesis  │ Tentative interpretation (kept separate from fact)     │
└─────────────┴────────────────────────────────────────────────────────┘
  1. Emphasize the separation: "The observation row is fact. The hypothesis row is interpretation. Never mix them."
  2. Set a minimum observation count: "Aim for at least 10 observations before drawing any conclusions"
  3. If applicable, set up monitoring tools: logging, metrics, screen recording

Expected: The person has a recording method ready and understands the critical distinction between observation and interpretation. They feel prepared to begin.

On failure: If the template feels too formal, simplify to: "Just write down what you see, and separately write what you think it means." If they resist recording ("I'll remember"), explain that unrecorded observations are subject to memory bias — the act of writing makes observation more accurate.

Step 3: Observe — Practice Sustained Neutral Attention

Guide the person through the actual observation session.

  1. Remind them of the stance: "You are a naturalist studying a new species. Do not interfere — just watch"
  2. For the first 5 minutes: encourage pure observation without recording — just attend
  3. After initial immersion: begin recording using the template
  4. Coach neutral language: "Instead of 'the system crashed,' try 'the system stopped responding at 14:32 after processing the 47th request'"
  5. Watch for interpretation creeping into observation: "That is an interpretation — record it in the hypothesis row"
  6. Encourage noting surprises: "What surprised you? Surprises often contain the most valuable data"
  7. Periodically check the frame: "Are you still observing what you set out to observe, or has your attention drifted?"
  8. If they want to intervene: "Note what you want to change and why, but do not change it yet — keep observing"

Expected: The person generates at least 5-10 concrete observations with specific evidence. They experience the difference between observing and interpreting, and find it harder than expected to maintain neutral attention.

On failure: If they keep interpreting instead of observing, try this exercise: "Describe what you see as if explaining it to someone who has never seen this system. Only use verifiable facts." If they run out of things to observe quickly, they are looking at too high a level — guide them to zoom in on details: timing, ordering, edge cases, exceptions.

Step 4: Record — Capture Findings with Field Notes

Help the person organize their raw observations into structured notes.

  1. Review their recorded observations together
  2. Check for completeness: does each observation have enough context to be understood later?
  3. Check for factual accuracy: are statements verifiable, or do they contain hidden assumptions?
  4. Group similar observations: "Do you see any patterns forming?"
  5. Note frequencies: how often did each pattern appear?
  6. Note absences: "What did you expect to see that was not there?"
  7. Help them separate strong observations (clear evidence) from weak observations (ambiguous data)

Expected: A set of organized field notes that cleanly separate observation from interpretation. The notes are detailed enough that someone else could verify the observations independently.

On failure: If the notes are too vague ("things seemed slow"), help them add specifics: "How slow? Compared to what? In which conditions?" If the notes are too detailed (recording everything), help them identify which observations relate to the original frame and which are noise.

Step 5: Analyze — Identify Patterns and Generate Hypotheses

Guide the person from observations to structured analysis.

  1. Lay out all observations and look for patterns:
    • Repetition: "This happened multiple times — is it systematic?"
    • Correlation: "X always happens alongside Y — are they related?"
    • Sequence: "A always precedes B — could A cause B?"
    • Absence: "X never happens in condition Z — why?"
    • Anomaly: "Everything follows pattern P except this one case — what is different?"
  2. For each pattern, ask: "Is there an alternative explanation?"
  3. Generate 2-3 hypotheses that explain the major patterns
  4. Distinguish between correlation and causation: "Observing that A and B co-occur does not prove A causes B"
  5. Identify which hypotheses are testable and what test would confirm/refute them
  6. Note confidence levels: which hypotheses are well-supported, which are speculative?

Expected: The person moves from raw observations to structured hypotheses while maintaining the discipline of separating data from theory. They have at least one testable hypothesis for their original question.

On failure: If they jump to a single explanation immediately, challenge it: "That is one possibility. What is another?" If they see no patterns, the observations may be too few — suggest continuing observation before analysis. If every observation seems to point to the same conclusion, they may be filtering — ask: "What evidence would contradict your current theory?"

Step 6: Report — Share Findings with Clear Structure

Help the person communicate their observations effectively.

  1. Structure the report:
    • Context: What was observed, when, why, under what conditions
    • Method: How the observation was conducted (protocol, tools, duration)
    • Findings: Key observations with evidence (data, not interpretation)
    • Analysis: Patterns identified, hypotheses generated, confidence levels
    • Recommendations: Suggested next steps (further observation, testing, intervention)
    • Limitations: What the observation did not cover, potential biases
  2. Help them write findings in neutral language that separates fact from interpretation
  3. Review for hidden assumptions or unsupported claims
  4. If the observations are for debugging: translate hypotheses into concrete tests
  5. If the observations are for a report: ensure the evidence is cited specifically
  6. If the observations are for personal understanding: summarize the key insights and remaining questions

Expected: A clear report that communicates observations, patterns, and hypotheses while maintaining the distinction between what was observed and what was inferred. The reader can evaluate the evidence independently.

On failure: If the report buries observations in interpretation, restructure: "Put all the facts in one section, all the theories in another." If the report lacks confidence levels ("this is definitely because..."), help them calibrate: "How sure are you? What would change your mind?"

Validation

  • The observation target was framed before observation began (not free-form wandering)
  • A recording protocol was established and used consistently
  • Observations were recorded as facts, separate from interpretations
  • At least 5 concrete, evidence-backed observations were captured
  • Patterns were identified through analysis, not assumed from the start
  • Hypotheses are testable and have stated confidence levels
  • The person experienced the discipline of observing before interpreting

Common Pitfalls

  • Observation as confirmation bias: Observing only things that support a pre-existing belief. The frame should include "look for evidence against your hypothesis" as an explicit instruction
  • Intervention urge: Seeing a problem and wanting to fix it immediately. Premature intervention often masks the root cause — observe first, then intervene with full understanding
  • Recording fatigue: Detailed observation is mentally taxing. Suggest breaks and realistic session lengths (30-60 minutes of focused observation is substantial)
  • Overcomplicating the protocol: For simple observations, a notebook and timestamps are sufficient. The protocol should serve the observation, not replace it
  • Confusing observation with surveillance: In interpersonal observation, ethical boundaries matter. Observe behavior that is visible, do not spy. If observing people, transparency is usually better than secrecy
  • Skipping the frame: Without a clear observation target, attention scatters and findings are unfocused. Even a rough frame is better than none

Related Skills

  • observe — the AI self-directed variant for sustained neutral pattern recognition across systems
  • learn-guidance — observation feeds learning by providing raw data for understanding
  • listen-guidance — listening is focused observation of a speaker; observation is broader-scope attention to any system
  • remote-viewing-guidance — shares structured observation methodology adapted for non-local perception
  • read-garden — garden observation skill that uses similar CRV-adapted sensory protocols

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Execute structural metamorphosis using strangler fig migration, chrysalis phases, and interface preservation. Covers transformation planning, parallel running, progressive cutover, rollback design, and post-metamorphosis stabilization for system architecture evolution. Use when assess-form has classified the system as READY for transformation, when migrating from monolith to microservices, when replacing a core subsystem while dependents continue operating, or when any architectural change must be gradual rather than big-bang.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

pjt222/agent-almanac422026년 10월 23일 업데이트

adaptic

무료

Master skill composing the 5-step synoptic cycle for panoramic synthesis across multiple domains. Orchestrates meditate, expand-awareness, observe, awareness, integrate-gestalt, and express-insight into a coherent process that produces unified understanding rather than sequential compromise. Use when a problem genuinely spans 3+ domains and the interactions between domains matter more than depth in any one, when sequential analysis feels like compromise rather than integration, or before major architectural decisions affecting multiple stakeholders.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

pjt222/agent-almanac422026년 10월 23일 업데이트

Scaffold a new puzzle type across all 10+ pipeline integration points in jigsawR. Creates the core puzzle module, wires it into the unified pipeline (generation, positioning, rendering, adjacency), adds ggpuzzle geom/stat layers, updates DESCRIPTION and config.yml, extends the Shiny app, and creates a comprehensive test suite. Use when adding a completely new puzzle type to the package or following the 10-point integration checklist to ensure nothing is missed end-to-end.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

pjt222/agent-almanac422026년 10월 23일 업데이트

Add Rcpp or RcppArmadillo integration to an R package for high-performance C++ code. Covers setup, writing C++ functions, RcppExports generation, testing compiled code, and debugging. Use when an R function is too slow and profiling confirms a bottleneck, when you need to interface with existing C/C++ libraries, or when implementing algorithms (loops, recursion, linear algebra) that benefit from compiled code.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

pjt222/agent-almanac422026년 10월 23일 업데이트

aikido

무료

Practice aikido as a defensive martial art emphasizing harmony, redirection, and controlled resolution. Covers centering and grounding, ukemi (safe falling and rolling), core techniques (irimi-nage, shiho-nage, kote-gaeshi, ikkyo), blending and tai sabaki (body movement), randori (multiple attacker practice), weapons awareness, and applying principles off the mat. Use when learning a defensive martial art that prioritizes de-escalation, developing the ability to redirect aggression without causing unnecessary harm, building safe falling skills, or cultivating calm centeredness under physical pressure.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

pjt222/agent-almanac422026년 10월 23일 업데이트

Analyze an arbitrary codebase to identify functions, APIs, and data sources suitable for exposure as MCP tools, producing a tool specification document. Use when planning an MCP server for an existing project, auditing a codebase before wrapping it as an AI-accessible tool surface, comparing what a codebase can do versus what is already exposed via MCP, or generating a tool spec to hand off to scaffold-mcp-server.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

pjt222/agent-almanac422026년 10월 23일 업데이트

pjt222의 스킬 모두 보기

이 스킬의 문제 신고