i18n/de/skills/observe-guidance/SKILL.md
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. Verwenden wenn a person wants to understand a system's behavior vor 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 durch direct observation.
npx skillsauth add pjt222/agent-almanac observe-guidanceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
meditate-guidance has cultivated sustained attention, the person wants to direct that attention toward a specific systemHelp the person set up a clear, bounded observation frame.
Erwartet: A clear observation frame with defined target, scope, purpose, and stance. The person knows what they are looking at and what they sind nicht looking at.
Bei Fehler: 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."
Help the person establish a systematic approach to recording what they observe.
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) │
└─────────────┴────────────────────────────────────────────────────────┘
Erwartet: The person has a recording method ready and understands the critical distinction zwischen observation and interpretation. They feel prepared to begin.
Bei Fehler: 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.
Guide the person durch the actual observation session.
Erwartet: The person generates mindestens 5-10 concrete observations with specific evidence. They experience the difference zwischen observing and interpreting, and find it harder than expected to maintain neutral attention.
Bei Fehler: If they keep interpreting stattdessen of observing, try this exercise: "Beschreiben 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, Grenzfaelle, exceptions.
Help the person organize their raw observations into structured notes.
Erwartet: 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.
Bei Fehler: 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.
Guide the person from observations to structured analysis.
Erwartet: The person moves from raw observations to structured hypotheses while maintaining the discipline of separating data from theory. They have mindestens one testable hypothesis for their original question.
Bei Fehler: If they jump to a single explanation sofort, challenge it: "That is one possibility. What is another?" If they see no patterns, the observations kann too few — suggest continuing observation vor analysis. If every observation seems to point to the same conclusion, they kann filtering — ask: "What evidence would contradict your current theory?"
Help the person communicate their observations effectively.
Erwartet: A clear report that communicates observations, patterns, and hypotheses while maintaining the distinction zwischen what was observed and what was inferred. The reader can evaluate the evidence independently.
Bei Fehler: If der Bericht buries observations in interpretation, restructure: "Put all the facts in one section, all the theories in another." If der Bericht lacks confidence levels ("this is definitely because..."), help them calibrate: "How sure are you? What would change your mind?"
observe — the AI self-directed variant for sustained neutral pattern recognition across systemslearn-guidance — observation feeds learning by providing raw data for understandinglisten-guidance — listening is focused observation of a speaker; observation is broader-scope attention to any systemremote-viewing-guidance — shares structured observation methodology adapted for non-local perceptionread-garden — garden observation skill that uses similar CRV-adapted sensory protocolstesting
Launch all available agents in parallel waves for open-ended hypothesis generation on problems where the correct domain is unknown. Use when facing a cross-domain problem with no clear starting point, when single-agent approaches have stalled, or when diverse perspectives are more valuable than deep expertise. Produces a ranked hypothesis set with convergence analysis and adversarial refinement.
tools
Write integration tests for a Node.js CLI application using the built-in node:test module. Covers the exec helper pattern, output assertions, filesystem state verification, cleanup hooks, JSON output parsing, error case testing, and state restoration after destructive tests. Use when adding tests to an existing CLI, testing a new command, verifying adapter behavior across frameworks, or setting up CI for a CLI tool.
development
Screen a proposed trademark for conflicts and distinctiveness before filing. Covers trademark database searches (TMview, WIPO Global Brand Database, USPTO TESS), distinctiveness analysis using the Abercrombie spectrum, likelihood of confusion assessment using DuPont factors and EUIPO relative grounds, common law rights evaluation, and goods/services overlap analysis. Produces a conflict report with a risk matrix. Use before adopting a new brand name, logo, or slogan — distinct from patent prior art search, which uses different databases, legal frameworks, and analysis methods.
tools
Scaffold a new CLI command using Commander.js with options, action handler, three output modes (human-readable, quiet, JSON), and optional ceremony variant. Covers command naming, option design, shared context patterns, error handling, and integration testing. Use when adding a command to an existing Commander.js CLI, designing a new CLI tool from scratch, or standardizing command structure across a multi-command CLI.