Finding

finding

Create and query curated findings in Crawlio's observation log. Findings are agent-created insights backed by observation evidence.

When to Use

Use this skill when the user wants to:

• Record an insight or issue discovered during analysis
• Create an evidence-backed finding that persists across sessions
• Review previously created findings for a site

Creating Findings

Findings are the agent's judgment layer on top of raw observations. A good finding:

1. Has a clear, descriptive title
2. References specific observation IDs as evidence
3. Includes a synthesis explaining the pattern or issue

Workflow

1. Query observations to identify patterns:

get_observations({ host: "example.com", source: "extension", limit: 50 })

2. Identify the pattern — look for recurring issues, framework signals, error patterns, or notable behaviors.

3. Create the finding with evidence:

create_finding({
  title: "Mixed content: HTTP images on HTTPS page",
  url: "https://example.com",
  evidence: ["obs_a3f7b2c1", "obs_b4e8c3d2"],
  synthesis: "Homepage loads 3 images over HTTP despite serving over HTTPS. Network observations show requests to http://cdn.example.com/img/ which should use HTTPS. This triggers mixed content warnings in Chrome and may cause images to be blocked in strict mode.",
  confidence: "high",
  category: "security"
})

Parameters

Finding Quality Checklist

• Title: Is it specific? "Mixed content on homepage" > "Issue found"
• Evidence: Do the observation IDs actually support the claim?
• Synthesis: Does it explain why this matters, not just what was observed?
• URL: Is it scoped to the right page or left empty for site-wide findings?

Querying Findings

All Findings

get_findings({})

Findings for a Specific Host

get_findings({ host: "example.com" })

Recent Findings

get_findings({ limit: 10 })

Finding Categories

When creating findings, consider these common categories:

Evidence Chain

The full evidence chain workflow:

1. analyze_page → returns evidenceId
2. create_finding → reference the evidenceId in the evidence array
3. get_observation → verify the evidence entry exists and supports the finding

Tips

• Create findings as you analyze, not all at the end — they persist across sessions
• Reference multiple observation IDs when a finding draws from several data points
• Use synthesis to explain the impact, not just restate the observation
• Findings with evidence chains are much more useful than findings without
• Use confidence to signal how strongly the evidence supports the claim
• Use category to enable filtering by dimension (performance, security, SEO, etc.)