GitHub

Cloud Rules

Audit rules powered by cloud services - what they check and what they cost

Cloud rules are regular audit rules that need data your machine doesn’t have - AI models, full filter lists, search demand data, or a shared link cache. They run automatically when you’re logged in and report skipped when you’re not.

The rules

Everything except the two opt-in gap rules is included in the audit’s flat base charge - see Credits & Pricing.

RuleWhat it checksCost
ai/llm-parsabilityHow well LLMs can parse and understand each pageincluded in audit base
ai/page-type-matchAI-classified page type agrees with declared structured dataincluded in audit base (shared with parsability)
eeat/authority-signalsPer-page authorship, citations, and outbound referencesincluded in audit base
adblock/element-hidingElements hidden by EasyList cosmetic rulesincluded in audit base, shared
adblock/blocked-linksLinks and resources ad blockers would blockshared with above
adblock/privacy-blockedTrackers that EasyPrivacy filter lists would blockshared with above
links/dead-linksExternal links verified through a shared global cacheincluded in audit base
gaps/keywordsKeywords competitors rank for that you don’t25 credits per audit, opt-in
gaps/contentTopic clusters with search demand you don’t cover25 credits per audit, opt-in

The three Blocking rules (IDs keep the adblock/ prefix) share a single blocklist check per audit, included in the audit base charge. They report as warnings in their own report section.

The two gap-analysis rules are disabled by default because of their cost. Enable them explicitly:

squirrel.toml
toml
[rules]
enable = ["gaps/keywords", "gaps/content"]

How they run

Cloud rules match rule filters like any other rule - enable = ["*"] (the default) includes them. During an audit, a dedicated cloud phase batches all the required service calls, then rules read the results. You’ll see the estimate in the start banner and the actual spend in the audit summary:

☁ Cloud credits used: 150 (audit-base 50, render 100)

Pages served from the render cache show as their own render-cached line at the same 2-credit rate, e.g. (audit-base 50, render 70, render-cached 30).

Skip behavior

A cloud rule never fails your audit. When it can’t run, it reports skipped with a reason:

Skip reasonMeaning
not-authenticatedNot logged in - run squirrel auth login
insufficient-creditsBalance too low - top up or lower the page count
credit-cap-reachedThe audit hit max_credits_per_audit; work was truncated at the cap
service-unavailableThe cloud service errored; charges for failed calls are refunded

Controlling spend

The per-audit cap, confirmation threshold, and --yes flag are covered in Credits & Pricing.

To opt out of specific cloud rules while keeping the rest:

squirrel.toml
toml
[rules]
disable = ["adblock/*", "links/dead-links"]

Or disable all cloud calls for a project:

squirrel.toml
toml
[cloud]
enabled = false

Type to search…

↑↓ navigate open esc close