Organic Growth
Use this skill when an operator needs to decide what to improve on a site for organic discovery: technical search health, content demand, landing-page performance, conversion quality, or the clarity and citeability that can help a page appear in answer engines.
The output is a decision packet, not a bag of SEO tips. It separates what the evidence shows from what the analyst infers, ranks the next actions by expected impact, confidence, and effort, and says how each action should be measured. No action is executed by this skill.
Evidence comes first
The default analyze runner accepts a bounded objective, the site, optional
business constraints, and any combination of:
- search-performance evidence, such as a sealed
google-search-consoleperformance packet; - analytics evidence, such as a sealed
google-analyticsreport packet; - site or market evidence with a SHA-256 source/content digest, source reference, kind, and bounded extracted summary.
Google is optional. The canonical workflow depends on evidence contracts, not a provider, connector, credential store, or hosted tenant. A local crawler, self-hosted analytics service, another search provider, third-party connector, or Runx-hosted connector can supply evidence when its packet has a stable digest and useful provenance. Connector ids, credential handles, URLs, and tenant configuration never belong in this skill.
The admission step rejects invalid packet schemas, failed validation, missing digests, and unbounded evidence. It gives the analysis agent the rows, metadata, caveats, and business context needed for judgment, capped to an explicit analysis view. The complete source packet remains bound by digest; the model must not pretend a bounded view is exhaustive.
Every material claim and recommended action must cite one or more admitted source
digests. Runx's native evidence verifier rejects invented references, changed
objective/site identity, empty claims, missing decision fields, and unsupported
external-effect claims. A failure becomes needs_more_evidence, not a polished
guess.
Reading the combined signal
Search evidence explains discovery: queries, pages, impressions, clicks, CTR, position, freshness, and coverage. Analytics explains behavior and business outcomes under the property's measurement model. Site evidence explains what is actually published, crawlable, structured, internally linked, and supportable.
Use their disagreement. Rising impressions with weak CTR can justify inspecting snippet fit, intent, brand recognition, or SERP composition. Strong clicks with weak engagement can justify checking landing-page promise, speed, navigation, or measurement. Analytics decline without a matching Search Console decline can point toward tagging, channel classification, consent, conversion configuration, or non-Google traffic. These are hypotheses until the relevant evidence is collected.
Compare identical date windows, page identities, search types, dimensions,
timezone assumptions, and definitions. Preserve incomplete Search Console data,
GA4 thresholding, sampling, (other)-row loss, pagination, and imported-source
status as caveats. Do not convert correlation into causation.
SEO and answer-engine work
Technical SEO recommendations require site evidence. Check indexability, canonicalization, robots rules, sitemap membership, status codes, rendering, structured data eligibility, internal discovery paths, and page duplication before prescribing a fix. Search Console URL inspection is a point observation, not authority to mutate the site or request indexing.
Content recommendations should connect a demonstrated audience need to a page, business outcome, and information gap. Avoid producing pages merely because a keyword exists. Consolidation, deletion, template repair, internal linking, or a better primary answer may beat another article.
For answer-engine or "GEO" work, optimize the underlying source quality: unambiguous entities, direct answers, original evidence, clear authorship and dates, machine-readable structure, stable URLs, strong internal context, and claims that another system can verify. There is no reliable switch for AI citations and no basis for guaranteeing inclusion. Treat answer-engine visibility as an observed channel that needs its own evidence, not as a mystical ranking score.
Action packet
A ready packet contains:
- an executive summary and bounded analysis scope;
- evidence-bound observations and explicit hypotheses;
- prioritized opportunities;
- recommended actions with rationale, source digests, owner type, effort, confidence, expected signal, stop condition, and verification method;
- a dedicated answer-engine review where evidence supports it;
- a measurement plan with baselines, leading and business outcomes, comparison windows, and rollback or reconsideration triggers;
- risks, missing evidence, and the authoritative source inventory.
The action list remains external_status: not_executed. Route implementation
to the owning repository or business workflow. Content changes may move through
a governed content pipeline; code and template work belongs in the site's
repository workflow; publication and provider mutations keep their own approval
and readback gates.
A useful operating loop
Run a narrow baseline, choose one evidence-bound action, make the change through its owner, wait for an appropriate observation window, then rerun the same queries. Preserve the original packet digests. Change several variables together only when the operator accepts that attribution will be weaker.
Stop when no source is admitted, page/property identity cannot be aligned, the date windows are incomparable, privacy or pagination caveats defeat the claim, the requested recommendation needs technical/content evidence that is absent, the agent cites a source outside the admitted set, or the objective asks for guaranteed ranking, mass low-value content, deceptive markup, or unapproved publication.
The deterministic module only admits and bounds organic-growth domain evidence. It does not hash evidence, call providers, or implement generic verification. Runx owns native digest provenance, evidence verification, agent receipts, and all downstream effect gates.
Agent task contract
organic-growth-analyze
Return growth_candidate with decision: ready, the exact objective and
site_url, executive_summary, observations, hypotheses, opportunities,
recommended_actions, geo_review, measurement_plan, claims, risks,
missing_evidence, and external_status: not_executed.
Each claim requires a non-empty claim and admitted source_digests. Every
recommended action requires non-empty source_digests plus a rationale,
priority, confidence, effort, expected_signal, verification, and stop_condition.
Mark statements as observed, inferred, or hypothesized. Preserve source caveats,
do not invent metrics or causes, and do not claim a change, publication,
provider call, ranking result, or AI citation occurred.
