agentleFS
pobo-builderpobo-builder/pobo-client-mcp/skills/product-analytics/SKILL.md

product-analytics

Skill1 starsChanged 59 days agoMITView on GitHub

Read and interpret Pobo Page Builder product performance analytics — how a product performs after its Pobo description went live. Use when the user asks how a product is doing, whether the new description helped, which parts of the description visitors read, or wants to find products whose content needs improvement. Uses the `pobo` MCP server tools.

26 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use query-optimization, learnings and 6 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ffsshhttiikkSkill

    query-optimization

    Database query optimization

    Also in 4 projects that use this

  • SossenbinderSkill

    learnings

    Extract non-obvious learnings from the current session and save them to auto memory. Use when the user wants to capture what was learned during a coding session.

    Also in 3 projects that use this

  • mmondoraSkill

    infrastructure-as-code

    Infrastructure as Code with Terraform and Pulumi. State management, modularity, drift detection, secrets handling. Use when provisioning cloud resources, writing Terraform/Pulumi modules, or managing infrastructure configuration.

    Also in 3 projects that use this

  • harrissohail6Skill

    database-design

    Database schema design and SQL best practices. Use when designing tables, writing queries, or optimizing database performance.

    Also in 3 projects that use this

  • attentiondotnetSkill

    animation-vocabulary

    Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

    Also in 3 projects that use this

  • nilssonrSkill

    seo

    Full SEO workflow for auditing pages and creating SEO-optimized content. Provides checklists with educational explanations aligned with Google Search Central documentation.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 25 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Correlation, not causality: Before/after changes and cart_rate_percent are correlations — engaged visitors scroll further AND buy more, and …

    line 59
  2. Distinctive:

    Call them "orders after viewing the product page".

    line 66

“Common” is measured: kept by at least 6 in 10 of the 25 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Pobo Page Builder product analytics

You read the performance analytics of a product's Pobo description and turn the numbers into content decisions. All data comes from the Pobo Page Builder backend — nothing runs on your machine.

Communicate with the user in their language (typically Czech).

Prerequisites & auth

The pobo MCP server is connected once via OAuth — the user runs claude mcp add -s user --transport http pobo https://api.pobo.space/mcp/client and logs in with their Pobo Page Builder account in the browser. If the pobo tools are unavailable, or MCP calls fail with 401 / unauthorized, tell the user:

Connect the Pobo server with claude mcp add -s user --transport http pobo https://api.pobo.space/mcp/client and sign in with your Pobo account in the browser. If the connection expired, run /mcp and sign in again.

There are no tokens to handle — never ask the user for credentials.

Workflow

  1. list_eshop — find the eshop to work with.
  2. find_product — resolve the user's identifier (EAN, product code, URL or name) to a Pobo product; list_product when they describe a set instead ("products with label X", "approved products in category Y").
  3. get_product_analytics — fetch the analytics (period 30d/60d/90d, default 90d).

What the data means

  • totals — page views, unique visitors, add-to-cart count and order count for the whole period.
  • pobo_content.first_detected_at — the day the Pobo description first appeared on the live page. Everything "before/after" pivots on this date.
  • before_after_summary — average daily views/add-to-cart and the add-to-cart rate before vs. after the description, with percent changes. Both sides cover a symmetric window (N days right before × first N days after detection, N = shorter side) so seasonality of a longer "before" stretch cannot skew the averages — before.days always equals after.days. before: null means the product has no history before the description (new product) — say so, do not invent a comparison.
  • engagement — scroll depth funnel (share of views reaching 25/50/75/100 % of the page), average active reading seconds, most opened FAQ questions.
  • section_map — the content heatmap: every section of the description (with its real widget name), how many visitors saw it (seen_percent), average dwell seconds and cart_rate_percent — the share of sessions that saw the section and later added the product to cart.

Interpretation rules (MANDATORY)

  • Correlation, not causality. Before/after changes and cart_rate_percent are correlations — engaged visitors scroll further AND buy more, and seasonality or campaigns move numbers too. Phrase findings as "after the description went live, X increased by Y%", never "the description caused it".
  • Orders are attributed, not complete. Order counts cover only sessions where the customer viewed the product page first, and only on Shoptet. Call them "orders after viewing the product page".
  • Null ≠ zero. null values and empty blocks mean not enough data was collected yet (tracking starts when the Pobo plugin ships to the eshop) — never present missing data as bad performance.
  • Small numbers make wild percentages — if the before period has little traffic, say the comparison is not reliable yet instead of quoting it.

Turning findings into action

  • Sections with high cart_rate_percent but low seen_percent are the gold: visitors who see them convert, but few scroll that far. Recommend moving them up in the description.
  • A scroll funnel that collapses early (e.g. only 20 % reach half the page) suggests the opening sections do not hold attention.
  • Top FAQ questions show what customers actually worry about — useful input for description copy.
  • For a batch of underperforming products, label them via list_label / create_label + assign_product_label so the content team can filter them in the Pobo admin grid (see the label-products skill).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.