From agent-almanac
Identifies insects via body plan verification, dichotomous keys to orders, wing venation, mouthparts, antennae morphology, leg structures, and confidence levels. For taxonomic study or distinguishing similar orders/families.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Records insect sightings with GPS location, date, weather, habitat, macro photos, behavior notes, preliminary ID, and iNaturalist submission. For field entomology, citizen science, journals.
Provides reasoning strategies for ecology and biodiversity research: species identification via GBIF/WoRMS, invasive species impacts, pollinator ecology, population dynamics, trophic interactions. For any ecology question.
Queries STRING API for protein-protein interactions (59M proteins, 20B interactions). Retrieves networks, performs GO/KEGG enrichment, maps IDs, analyzes connectivity for systems biology.
Share bugs, ideas, or general feedback.
Identify insects using systematic morphological examination, dichotomous keys, and structured confidence assessment.
Confirm you are looking at an insect and not another arthropod. This step prevents misidentification at the most fundamental level.
Arthropod Verification:
+--------------------+------------------------------------------+
| Feature | Insect (Class Insecta) |
+--------------------+------------------------------------------+
| Legs | Exactly 6 (3 pairs), attached to thorax |
+--------------------+------------------------------------------+
| Body regions | 3 distinct: head, thorax, abdomen |
+--------------------+------------------------------------------+
| Antennae | 1 pair on the head |
+--------------------+------------------------------------------+
| Eyes | Typically 2 compound eyes + 0-3 ocelli |
+--------------------+------------------------------------------+
| Wings | 0, 2, or 4 (attached to thorax) |
+--------------------+------------------------------------------+
Not an insect if:
- 8 legs → Arachnida (spiders, scorpions, ticks, mites)
- 10+ legs → Crustacea (isopods, amphipods) or Myriapoda
- No distinct head → likely a mite or tick
- 2 pairs antennae → Crustacea
- No antennae → Arachnida
Expected: Confirmation that the organism is an insect with 6 legs, 3 body regions, 1 pair of antennae, and 0-4 wings.
On failure: If the specimen has 8 legs, it is an arachnid — do not proceed with insect keys. If leg count is ambiguous (e.g., legs lost on preserved specimen), examine thoracic leg attachments — insects have 3 pairs of coxae on the pro-, meso-, and metathorax. If the body plan is genuinely unclear, record "Arthropoda — class uncertain" and note what features are visible.
Work through the following simplified key one couplet at a time. At each couplet, choose the option that matches your specimen and follow the lead number.
Simplified Dichotomous Key to Major Insect Orders:
1a. Wings present and visible ................................. go to 2
1b. Wings absent (apterous) .................................. go to 12
2a. One pair of wings (hind wings reduced to halteres) ....... DIPTERA
(flies, mosquitoes, midges, crane flies)
2b. Two pairs of wings ........................................ go to 3
3a. Front wings hardened, meeting in a straight line
down the back (elytra) ................................... COLEOPTERA
(beetles, weevils, ladybugs, fireflies)
3b. Front wings not fully hardened as elytra ................. go to 4
4a. Wings covered in scales (powdery when rubbed) ............ LEPIDOPTERA
(butterflies and moths)
4b. Wings membranous or partly membranous, no scales ......... go to 5
5a. Front wings half-leathery at base, membranous at
tip (hemelytra) .......................................... HEMIPTERA
(true bugs: stink bugs, assassin bugs, bed bugs)
5b. Front wings uniformly membranous or uniformly
leathery ................................................. go to 6
6a. Narrow waist between thorax and abdomen; hind wings
smaller than front wings; wings may hook together ........ HYMENOPTERA
(bees, wasps, ants, sawflies)
6b. No narrow waist ........................................... go to 7
7a. Long, narrow body; very large eyes covering most of
head; wings held out to sides or above body at rest ...... ODONATA
(dragonflies and damselflies)
7b. Body not as above ......................................... go to 8
8a. Hind legs greatly enlarged for jumping ................... ORTHOPTERA
(grasshoppers, crickets, katydids)
8b. Hind legs not enlarged for jumping ....................... go to 9
9a. Front wings straight, narrow, leathery (tegmina);
cerci prominent at abdomen tip ........................... DERMAPTERA
(earwigs) — if cerci are forceps-like
or BLATTODEA (cockroaches) — if cerci are short
9b. Wings otherwise ........................................... go to 10
10a. Tiny insects (under 5mm); wings fringed with long
hairs ................................................... THYSANOPTERA
(thrips)
10b. Wings not fringed ........................................ go to 11
11a. Two pairs of similar-sized membranous wings with
many veins; soft body; often near water ................. NEUROPTERA
(lacewings, antlions) or EPHEMEROPTERA (mayflies —
have 2-3 tail filaments) or PLECOPTERA (stoneflies —
have 2 tail filaments, wings fold flat)
11b. Does not match above ..................................... record
features and consult a comprehensive regional key
12a. Laterally flattened body; jumps .......................... SIPHONAPTERA
(fleas)
12b. Pale, soft body; bead-like antennae; social,
found in wood or soil ................................... BLATTODEA
(termites, formerly Isoptera)
12c. Very small (under 2mm); elongate; found on hosts ........ PHTHIRAPTERA
(lice)
12d. 6 legs, wingless, does not match above .................. record
features and consult a comprehensive regional key
(many wingless forms exist within winged orders)
Expected: Identification to order with a clear path through the key documented (e.g., "1a to 2b to 3a = Coleoptera").
On failure: If the specimen does not clearly match any couplet, it may be a wingless form of a normally winged order (e.g., worker ants are wingless Hymenoptera, female bagworm moths are wingless Lepidoptera). Note which couplet caused difficulty and what features are ambiguous. Consult a more detailed regional key or photograph the specimen for expert review.
Wings carry diagnostic information at family and genus level beyond what the dichotomous key captures.
Wing Types by Order:
+--------------------+------------------------------------------+
| Wing Type | Orders |
+--------------------+------------------------------------------+
| Elytra (hardened | Coleoptera — front wings meet in a |
| front wings) | straight line; hind wings membranous, |
| | folded beneath |
+--------------------+------------------------------------------+
| Hemelytra (partly | Hemiptera — basal half leathery, distal |
| hardened) | half membranous |
+--------------------+------------------------------------------+
| Tegmina (leathery | Orthoptera, Blattodea — uniformly |
| front wings) | leathery; hind wings membranous, folded |
+--------------------+------------------------------------------+
| Scaled | Lepidoptera — covered in overlapping |
| | scales; venation visible when descaled |
+--------------------+------------------------------------------+
| Membranous (both | Hymenoptera, Odonata, Neuroptera, |
| pairs) | Ephemeroptera, Plecoptera |
+--------------------+------------------------------------------+
| Halteres (reduced | Diptera — hind wings reduced to knob- |
| hind wings) | like balancing organs |
+--------------------+------------------------------------------+
| Fringed | Thysanoptera — narrow wings with long |
| | marginal hairs |
+--------------------+------------------------------------------+
Venation Notes:
- Count the major longitudinal veins (costa, subcosta, radius, media,
cubitus, anal veins) — number and branching pattern are family-diagnostic
- Note cross-veins forming cells — the number and shape of closed cells
help distinguish families
- Wing coupling mechanisms (hamuli in Hymenoptera, frenulum in
Lepidoptera) indicate how front and hind wings link during flight
Expected: Wing type classified and major venation features noted. For common orders, this may confirm or refine the order-level identification.
On failure: If wings are damaged, missing, or folded such that venation is not visible, note what can be seen (e.g., "elytra present, hind wings not examined") and proceed to the next step. Wing venation is most useful at the family level — order-level identification usually does not require detailed venation.
Mouthpart type reflects feeding ecology and is diagnostic at the order level.
Mouthpart Types:
+--------------------+------------------------------------------+
| Type | Description and Associated Orders |
+--------------------+------------------------------------------+
| Chewing | Mandibles with toothed or grinding |
| (mandibulate) | surfaces. Coleoptera, Orthoptera, |
| | Hymenoptera (partially), Odonata larvae, |
| | Neuroptera |
+--------------------+------------------------------------------+
| Piercing-sucking | Elongate stylets within a beak-like |
| | rostrum. Hemiptera, Siphonaptera, |
| | Phthiraptera, some Diptera (mosquitoes) |
+--------------------+------------------------------------------+
| Siphoning | Coiled proboscis (haustellum) unrolled |
| | to feed on nectar. Lepidoptera (adults) |
+--------------------+------------------------------------------+
| Sponging | Fleshy labellum with pseudotracheal |
| | channels. Many Diptera (house flies) |
+--------------------+------------------------------------------+
| Chewing-lapping | Mandibles for manipulating + tongue |
| | (glossa) for lapping liquids. |
| | Hymenoptera (bees) |
+--------------------+------------------------------------------+
| Rasping-sucking | Asymmetric mouthparts that rasp tissue |
| | and suck fluids. Thysanoptera |
+--------------------+------------------------------------------+
Expected: Mouthpart type classified (chewing, piercing-sucking, siphoning, sponging, or chewing-lapping) and noted as consistent or inconsistent with the order identification from Step 2.
On failure: Mouthparts are often difficult to see on live or small specimens without magnification. If mouthparts cannot be examined, skip this step and note "mouthparts not examined." For photographs, a frontal view may reveal the mouthpart type. This step is confirmatory, not mandatory for order-level identification.
Antennal form is one of the most visually accessible features and is diagnostic at the family level in many orders.
Antenna Types:
+--------------------+------------------------------------------+
| Form | Description and Diagnostic Value |
+--------------------+------------------------------------------+
| Filiform | Thread-like, segments similar in size. |
| | Many Orthoptera, some Coleoptera |
+--------------------+------------------------------------------+
| Moniliform | Bead-like, round segments. Termites, |
| | some Coleoptera |
+--------------------+------------------------------------------+
| Clavate | Gradually thickened toward tip. |
| | Some Coleoptera (darkling beetles) |
+--------------------+------------------------------------------+
| Capitate | Abrupt terminal club. Butterflies |
| | (Lepidoptera: Rhopalocera) |
+--------------------+------------------------------------------+
| Serrate | Saw-toothed segments. Some Coleoptera |
| | (click beetles, jewel beetles) |
+--------------------+------------------------------------------+
| Pectinate | Comb-like branches on one side. |
| | Some moths, some Coleoptera |
+--------------------+------------------------------------------+
| Bipectinate | Comb-like branches on both sides. |
| | Many moths (especially males, for |
| | detecting pheromones) |
+--------------------+------------------------------------------+
| Plumose | Feathery, densely branched. Male |
| | mosquitoes and midges (Diptera) |
+--------------------+------------------------------------------+
| Lamellate | Terminal segments expanded into flat |
| | plates. Scarab beetles (Scarabaeidae) |
+--------------------+------------------------------------------+
| Geniculate | Elbowed — a long first segment (scape) |
| | followed by an angle. Ants, weevils, |
| | many Hymenoptera |
+--------------------+------------------------------------------+
| Aristate | Short, 3-segmented with a bristle |
| | (arista). Many Diptera (house flies, |
| | fruit flies) |
+--------------------+------------------------------------------+
| Stylate | Short, with a terminal style (finger- |
| | like projection). Some Diptera |
| | (horse flies, robber flies) |
+--------------------+------------------------------------------+
Expected: Antenna form identified and recorded. The antennal type should be consistent with the order identified in Step 2 (e.g., lamellate antennae confirm Scarabaeidae within Coleoptera; capitate antennae confirm butterfly rather than moth within Lepidoptera).
On failure: If antennae are broken, missing, or obscured in photographs, note "antennae not fully visible — appeared [filiform/clubbed/etc.] from what was observed." Antennal form is one of the most reliable features for family-level identification, so the loss of this character reduces confidence. Proceed to Step 6.
Leg specialization reveals the insect's ecology, and tarsal formula (number of segments per tarsus) is diagnostic at the family level in several orders.
Leg Specializations:
+--------------------+------------------------------------------+
| Specialization | Description and Examples |
+--------------------+------------------------------------------+
| Cursorial | Long, slender, built for running. |
| (running) | Ground beetles (Carabidae), cockroaches |
+--------------------+------------------------------------------+
| Saltatorial | Enlarged hind femora for jumping. |
| (jumping) | Grasshoppers, fleas, flea beetles |
+--------------------+------------------------------------------+
| Raptorial | Front legs with spined femur and tibia |
| (grasping) | for seizing prey. Praying mantises, |
| | some Hemiptera (ambush bugs) |
+--------------------+------------------------------------------+
| Fossorial | Front legs broad and flattened for |
| (digging) | digging. Mole crickets, scarab larvae |
+--------------------+------------------------------------------+
| Natatorial | Hind legs flattened and fringed with |
| (swimming) | hairs for rowing. Water beetles, |
| | water boatmen |
+--------------------+------------------------------------------+
| Scansorial | Tarsi with adhesive pads or claws for |
| (climbing) | gripping surfaces. Many beetles, flies |
+--------------------+------------------------------------------+
| Corbiculate | Hind tibiae with pollen basket (corbicula)|
| | Honey bees, bumble bees |
+--------------------+------------------------------------------+
Tarsal Formula:
- Count tarsal segments on front, middle, and hind legs
- Express as 3 numbers (e.g., 5-5-5 means 5 segments on all legs)
- Common formulas:
5-5-5: Most Coleoptera families, Hymenoptera, Neuroptera
5-5-4: Cerambycidae, Chrysomelidae (apparent — actually cryptic 5th)
4-4-4: Some smaller beetle families
3-3-3: Some flies (Diptera)
Variable: Check all three pairs — asymmetry is diagnostic
Expected: Leg specialization type recorded and tarsal formula counted (if specimen allows). These features narrow identification within the order.
On failure: If the specimen is too small for tarsal segments to be counted without a microscope, note the overall leg shape and any obvious specialization (jumping legs, digging legs). Tarsal formula is most useful for Coleoptera families — for other orders, general leg shape is sufficient.
Synthesize all observations into a final identification with an explicit confidence rating.
Confidence Assessment:
+----------+---------------------------+---------------------------+
| Level | Criteria | Action |
+----------+---------------------------+---------------------------+
| Certain | All morphological features| Record as confirmed ID. |
| | match; keyed through | Label specimen or |
| | dichotomous key cleanly; | observation with species |
| | no similar species in | name. |
| | region could be confused | |
+----------+---------------------------+---------------------------+
| Probable | Most features match; | Record as probable ID. |
| | keyed to family or genus; | Note which features are |
| | 1-2 features uncertain or | uncertain. Seek additional|
| | not examined | references or expert |
| | | confirmation. |
+----------+---------------------------+---------------------------+
| Possible | Some features match; | Record as possible ID. |
| | keyed to order but not | Photograph thoroughly. |
| | further; similar taxa not | Submit to expert forum or |
| | fully eliminated | citizen science platform |
| | | for community review. |
+----------+---------------------------+---------------------------+
| Unknown | Cannot key beyond class | Record all visible |
| | Insecta; features not | features. Photograph. |
| | matching available keys; | Seek expert identification|
| | specimen too damaged for | or use molecular methods |
| | morphological ID | (DNA barcoding). |
+----------+---------------------------+---------------------------+
Record your identification in this format:
Order: [name]
Family: [name or "uncertain"]
Genus: [name or "uncertain"]
Species: [name or "uncertain"]
Confidence: [Certain / Probable / Possible / Unknown]
Features examined: [list which steps were completed]
Features uncertain: [list any ambiguous characters]
Similar taxa considered: [what else it might be and why rejected]
Expected: A completed identification record with order (minimum), family and genus (if possible), explicit confidence level, and documentation of which features were examined and which were uncertain.
On failure: If the identification stalls at order level, that is a valid outcome. Record all features observed and submit photographs to expert forums or citizen science platforms. Many insects require specialist knowledge or even genital dissection for species-level identification — this is normal, not a failure of the method.
document-insect-sighting — record the sighting with photographs and metadata before or during identificationobserve-insect-behavior — behavioral observations that supplement morphological identification with ecological contextcollect-preserve-specimens — when a physical specimen is needed for definitive identification under magnificationsurvey-insect-population — applying identification skills across multiple specimens in a population-level survey