Back to Skills

observe-insect-behavior

pjt222
Updated 2 days ago
4 views
17
2
17
View on GitHub
Documentationwordapidata

About

This Claude Skill provides structured protocols for observing and recording insect behavior, including defined ethogram categories and multiple sampling methods. It enables timestamped event logging, interaction tracking, and environmental data documentation for analysis. Use it for ecological research, species behavior studies, or conservation assessments requiring systematic behavioral data.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/observe-insect-behavior

Copy and paste this command in Claude Code to install this skill

Documentation

Observe Insect Behavior

Conduct structured insect behavior observations using standardized sampling protocols, ethograms, and quantitative recording methods.

When Use

  • Studying insect behavior for ecological or entomological research
  • Want to document behavioral repertoire of species at site
  • Observing pollinator activity on flowering plants
  • Documenting predator-prey interactions or parasitoid behavior
  • Need behavioral data to support conservation or management decisions
  • Building ethological skills through structured field practice

Inputs

  • Required: Focal insect or insect aggregation to observe
  • Required: Timing device (watch, phone, or stopwatch)
  • Required: Recording method (notebook, voice recorder, or data entry device)
  • Optional: Hand lens (10x) for close behavioral observation
  • Optional: Binoculars for distant insects (e.g., dragonflies on patrol)
  • Optional: Camera for video documentation of behavioral events
  • Optional: Thermometer, hygrometer, or weather station for environmental data
  • Optional: Pre-printed data sheets or ethogram templates

Steps

Step 1: Choose Sampling Protocol

Select protocol matching research question and behavior of target insect. Each has specific strengths and biases.

Sampling Protocols:
+--------------------+------------------------------------------+
| Protocol           | Description and Best Use                 |
+--------------------+------------------------------------------+
| Focal animal       | Follow one individual continuously for   |
| sampling           | a fixed time period. Record all          |
|                    | behaviors as they occur.                 |
|                    | Best for: detailed behavioral sequences, |
|                    | time budgets, individual-level data.     |
|                    | Duration: 5-30 minutes per focal bout.   |
|                    | Bias: loses data when individual moves   |
|                    | out of sight.                            |
+--------------------+------------------------------------------+
| Scan sampling      | At fixed intervals (e.g., every 60       |
|                    | seconds), quickly scan all visible       |
|                    | individuals and record what each is      |
|                    | doing at that instant.                   |
|                    | Best for: group-level behavior, activity |
|                    | proportions, social insects.             |
|                    | Bias: misses rare or brief behaviors.    |
+--------------------+------------------------------------------+
| All-occurrences    | Record every instance of a specific      |
| sampling           | behavior (e.g., every flower visit,      |
|                    | every aggressive encounter) within a     |
|                    | defined area and time.                   |
|                    | Best for: rare but conspicuous events,   |
|                    | interaction rates, pollinator visits.    |
|                    | Bias: misses simultaneous events.        |
+--------------------+------------------------------------------+
| Instantaneous      | At fixed intervals, record the behavior  |
| (point) sampling   | of one focal individual at that exact    |
|                    | instant. Often combined with focal       |
|                    | animal sampling.                         |
|                    | Best for: time budget calculation with   |
|                    | statistical rigor.                       |
|                    | Bias: misses brief behaviors between     |
|                    | sample points.                           |
+--------------------+------------------------------------------+

Choosing a Protocol:
- "I want to know everything one individual does" → focal animal
- "I want to know what a group is doing right now" → scan
- "I want to count how often a specific event happens" → all-occurrences
- "I want statistically rigorous time budgets" → instantaneous

Got: Sampling protocol selected and justified based on research question, target taxon, field conditions. Recording interval or focal bout duration defined before observation begins.

If fail: Target too mobile for focal sampling (e.g., fast-flying dragonfly)? Switch to all-occurrences sampling on specific events (territorial chases, perch returns). Can't distinguish individuals for focal sampling? Use scan sampling on group. Adapt protocol to what's feasible rather than abandon observation.

Step 2: Define Ethogram

Ethogram is catalog of all behaviors you record. Define before observation begins so you don't improvise categories in field.

Standard Insect Ethogram:
+--------------------+------------------------------------------+
| Category           | Behavioral States and Events             |
+--------------------+------------------------------------------+
| Locomotion         | Walking, running, flying (straight,      |
|                    | hovering, patrolling, pursuit), jumping, |
|                    | crawling, climbing, burrowing, swimming  |
+--------------------+------------------------------------------+
| Feeding            | Probing (flower, substrate), chewing     |
|                    | (leaf, prey), sucking (phloem, blood,    |
|                    | nectar), lapping, regurgitating, filter  |
|                    | feeding (aquatic larvae)                 |
+--------------------+------------------------------------------+
| Grooming           | Leg rubbing (cleaning antennae with      |
|                    | front legs), wing cleaning, body         |
|                    | brushing, proboscis extension/retraction |
+--------------------+------------------------------------------+
| Reproduction       | Courtship display, copulation attempt,   |
|                    | copulation, mate guarding, oviposition   |
|                    | (egg-laying), nest construction          |
+--------------------+------------------------------------------+
| Defense            | Fleeing, dropping (thanatosis/death      |
|                    | feigning), startle display (wing flash), |
|                    | stinging, biting, chemical release       |
|                    | (spraying, bleeding), aggregation        |
+--------------------+------------------------------------------+
| Communication      | Stridulation (sound production),         |
|                    | pheromone release (wing fanning, gland   |
|                    | exposure), visual signaling (wing        |
|                    | display, bioluminescence), vibrational   |
|                    | signaling (substrate drumming)           |
+--------------------+------------------------------------------+
| Rest               | Stationary with no visible activity,     |
|                    | basking (thermoregulation in sun),       |
|                    | roosting, sheltering                     |
+--------------------+------------------------------------------+

Modifiers (append to any category):
- Substrate: on leaf, on flower, on bark, on ground, on water, in flight
- Orientation: upward, downward, horizontal, head-into-wind
- Intensity: low (slow, intermittent), medium, high (rapid, sustained)

Got: Complete ethogram defined for target taxon before observation begins. Categories mutually exclusive (any behavior fits exactly one category) and exhaustive (every observed behavior classifiable).

If fail: Unexpected behavior occurs not fitting ethogram? Record verbatim (e.g., "rapid wing vibration while stationary, no defined category match") and add new category in post-observation revision. Don't force novel behaviors into ill-fitting categories.

Step 3: Record Behavioral Events with Timestamps

Begin observation, record each event or state change with precise timing.

Recording Format:

Continuous recording (focal animal):
  Time    | Behavior         | Substrate   | Notes
  --------+------------------+-------------+------------------
  00:00   | Rest             | Leaf (upper)| Dorsal basking
  00:45   | Grooming         | Leaf (upper)| Front legs cleaning antennae
  01:12   | Walking          | Leaf (upper)| Toward leaf edge
  01:30   | Flying           | In flight   | Short flight, 2m
  01:35   | Landing          | Flower head | Tarsi gripping petals
  01:40   | Feeding (nectar) | Flower head | Proboscis extended
  03:15   | Flying           | In flight   | Left observation area
  03:15   | END — focal lost |             | Duration: 3 min 15 sec

Instantaneous recording (at 30-second intervals):
  Time    | Behavior         | Substrate
  --------+------------------+-------------
  00:00   | Rest             | Leaf
  00:30   | Rest             | Leaf
  01:00   | Feeding          | Flower
  01:30   | Feeding          | Flower
  02:00   | Grooming         | Flower
  02:30   | Flying           | In flight

Rules:
- Start the timer before observing; record time to nearest second
  for continuous, to nearest interval for instantaneous
- Record state changes immediately — do not wait for the next interval
  in continuous recording
- If behavior is ambiguous, record what you see, not what you interpret
  (e.g., "rapid wing vibration" not "aggression")
- Note when focal individual is lost and reason (flew away, obscured)

Got: Continuous or interval-based record of behavioral events with timestamps, covering full observation period.

If fail: Focal individual lost mid-observation? Record time and reason. Returns? Resume recording. Doesn't? Partial record still valid data — note actual duration. Scan sampling, some individuals obscured at scan moment? Record only those visible, note count of unscored individuals.

Step 4: Log Interactions

Record all interactions between focal insect and other organisms. Interactions are events involving two or more individuals.

Interaction Recording Format:
  Time  | Focal behavior  | Partner(s)       | Partner behavior | Outcome
  ------+-----------------+------------------+------------------+----------
  02:10 | Chase (flying)  | Conspecific male  | Fleeing          | Focal won
  04:30 | Feeding (flower)| Honey bee         | Approaching      | Focal left
  06:15 | Death feigning  | Spider (Salticid) | Stalking         | Spider left

Interaction Types:
+--------------------+------------------------------------------+
| Type               | Examples                                 |
+--------------------+------------------------------------------+
| Intraspecific      | Territorial defense, courtship, mate     |
| (same species)     | competition, dominance, aggregation,     |
|                    | cooperation (social insects)             |
+--------------------+------------------------------------------+
| Predation          | Focal insect capturing prey, or focal    |
|                    | insect being attacked by predator        |
+--------------------+------------------------------------------+
| Parasitism         | Parasitoid ovipositing on/in focal; fly  |
|                    | or mite parasitizing focal               |
+--------------------+------------------------------------------+
| Mutualism          | Pollination (insect-plant), ant-aphid    |
|                    | tending, mycangial fungi transport       |
+--------------------+------------------------------------------+
| Competition        | Displacement from food source,           |
| (interspecific)    | interference at nest site                |
+--------------------+------------------------------------------+

For each interaction record:
- Who initiated (focal or partner)
- Duration of the interaction
- Outcome (winner/loser, successful/unsuccessful, mutual withdrawal)
- Distance at which interaction began

Got: All observed interactions recorded with initiator, partner identity (to lowest taxonomic level possible), behaviors of both parties, outcome.

If fail: Interactions too rapid to record fully (e.g., swarm of competing males)? Focus on focal individual's behavior, note "multiple simultaneous interactions — details approximate." Partner identity unknown? Describe (e.g., "small black hymenopteran, ~8mm").

Step 5: Record Environmental Context

Environmental conditions strongly influence insect behavior. Record covariates so behavioral data interpretable in ecological context.

Environmental Context Record:
+--------------------+------------------------------------------+
| Variable           | How to Record                            |
+--------------------+------------------------------------------+
| Air temperature    | Thermometer reading at insect height,    |
|                    | in shade. Record at start and end of     |
|                    | observation, and hourly for long sessions|
+--------------------+------------------------------------------+
| Relative humidity  | Hygrometer reading. Particularly         |
|                    | important for small insects sensitive    |
|                    | to desiccation                           |
+--------------------+------------------------------------------+
| Wind speed         | Estimate: calm, light (leaves rustle),   |
|                    | moderate (small branches move), strong   |
|                    | (large branches sway). Anemometer if    |
|                    | available                                |
+--------------------+------------------------------------------+
| Cloud cover        | Estimate in oktas (eighths): 0 = clear,  |
|                    | 4 = half-covered, 8 = overcast          |
+--------------------+------------------------------------------+
| Light intensity    | Full sun, partial shade, full shade, or  |
|                    | lux meter reading if available           |
+--------------------+------------------------------------------+
| Time of day        | Record start and end times. Note         |
|                    | position relative to sunrise/sunset for  |
|                    | crepuscular species                      |
+--------------------+------------------------------------------+
| Substrate temp     | Surface temperature where insect is      |
|                    | resting (IR thermometer if available).   |
|                    | Important for basking behavior           |
+--------------------+------------------------------------------+
| Recent weather     | Rain in past 24 hours, frost, drought    |
|                    | conditions — these affect emergence and  |
|                    | activity levels                          |
+--------------------+------------------------------------------+

Got: Environmental covariates recorded at start and end of each observation session, with intermediate readings for sessions longer than 1 hour.

If fail: Instrumentation unavailable? Estimate temperature ("warm, ~25C"), humidity ("dry" or "humid"), wind from sensory cues. Approximate environmental data far more useful than none. Minimum: time of day, cloud cover, estimated temp.

Step 6: Summarize Observations

Analyze recorded data to produce structured summary with time budgets, behavioral frequencies, observed patterns.

Summary Analysis:

1. TIME BUDGET (from focal or instantaneous sampling):
   Calculate the proportion of observation time spent in each
   ethogram category.
   Example:
     Feeding:    45% (13.5 min of 30 min observation)
     Locomotion: 25% (7.5 min)
     Grooming:   12% (3.6 min)
     Rest:       10% (3.0 min)
     Defense:     5% (1.5 min)
     Reproduction:3% (0.9 min)

2. BEHAVIORAL FREQUENCIES (from all-occurrences sampling):
   Count the number of times each event occurred per unit time.
   Example:
     Flower visits: 12 per 30 minutes = 0.4 visits/min
     Territorial chases: 3 per 30 minutes = 0.1 chases/min
     Grooming bouts: 8 per 30 minutes = 0.27 bouts/min

3. INTERACTION SUMMARY:
   Tabulate interactions by type and outcome.
   Example:
     Intraspecific aggressive: 3 (focal won 2, lost 1)
     Interspecific displacement: 2 (focal displaced 1, was displaced 1)
     Predation attempt on focal: 1 (unsuccessful)

4. PATTERNS AND OBSERVATIONS:
   Note any temporal patterns (behavior changes with time of day),
   environmental correlations (activity increases with temperature),
   or unexpected behaviors not previously documented for the species.

5. LIMITATIONS:
   Note observation duration, number of focal bouts, any periods
   when the focal individual was lost, and weather conditions that
   may have affected behavior.

Got: Structured summary including time budget or behavioral frequencies (depending on sampling protocol), interaction summary, observed patterns, and explicit acknowledgment of limitations.

If fail: Session too short for meaningful time budgets (< 10 min continuous data)? Report raw event counts rather than proportions. Note short duration as limitation. Even brief observations contribute if honestly reported — 5-min observation documenting rare behavior (e.g., parasitoid oviposition) can be more valuable than hours of resting behavior.

Checks

  • Sampling protocol selected and justified before observation began
  • Ethogram defined with mutually exclusive and exhaustive categories
  • Behavioral events recorded with timestamps throughout observation
  • Interactions logged with initiator, partner, behaviors, outcomes
  • Environmental covariates recorded at start and end of observation
  • Summary analysis produced with time budgets or behavioral frequencies
  • Limitations of observation (duration, lost focal time, weather) noted

Pitfalls

  • Starting without ethogram: Improvising categories during observation leads to inconsistent recording. Define before first observation, even if revised after
  • Interpreting instead of describing: Record "mandibles opening and closing rapidly on leaf margin" not "aggressive feeding." Interpretation comes in analysis, not field recording. Anthropomorphic labels ("angry," "happy," "confused") have no place in ethological data
  • Observer fatigue: Continuous focal sampling cognitively demanding. Limit focal bouts to 15-30 min with breaks between. Tired observers miss events, make recording errors
  • Disturbing subject: Your presence changes behavior. Maintain distance, minimize movement, avoid casting shadows on insect, allow habituation period (2-5 min) before formal recording
  • Ignoring "nothing happening": Rest and inactivity are valid behavioral states that must be recorded. Insect spending 60% of time resting is important ecological finding, not boring data to skip
  • Confusing states and events: State has duration (feeding for 3 min). Event is instantaneous (single wing flash). Record states with start and end times; events with single timestamp. Mixing produces incoherent time budgets

See Also

  • document-insect-sighting — record sighting with photographs, location, metadata as complement to behavioral observations
  • identify-insect — identify species being observed; essential for interpreting behavior in taxonomic context
  • collect-preserve-specimens — collect voucher specimens to confirm identity of species whose behavior was observed
  • survey-insect-population — scale behavioral observations across population to understand community-level behavioral ecology

GitHub Repository

pjt222/agent-almanac
Path: i18n/caveman/skills/observe-insect-behavior
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

railway-docs

Documentation

This skill fetches current Railway documentation to answer questions about features, functionality, or specific docs URLs. It ensures developers receive accurate, up-to-date information directly from Railway's official sources. Use it when users ask how Railway works or reference Railway documentation.

View skill

n8n-code-python

Documentation

This Claude Skill provides expert guidance for writing Python code in n8n's Code nodes, specifically for using Python's standard library and working with n8n's special syntax like `_input`, `_json`, and `_node`. It helps developers understand Python's limitations within n8n and recommends using JavaScript for most workflows while offering Python solutions for specific data transformation needs.

View skill

archon

Documentation

The Archon skill provides RAG-powered semantic search and project management through a REST API. Use it for querying documentation, managing hierarchical projects/tasks, and performing knowledge retrieval with document upload capabilities. Always prioritize Archon first when searching external documentation before using other sources.

View skill

n8n-code-javascript

Documentation

This Claude Skill provides expert guidance for writing JavaScript code in n8n's Code nodes. It covers essential n8n-specific syntax like `$input`/`$json` variables, HTTP helpers, and DateTime handling, while troubleshooting common errors. Use it when developing n8n workflows that require custom JavaScript processing in Code nodes.

View skill