agentleFS
reatlatreatlat/fullstory-claude-plugin/skills/page-performance/SKILL.md

page-performance

Skill36 starsChanged 14 days agoMITView on GitHub

Page-level performance analysis — load times, errors by page, device breakdown, and page-to-page navigation patterns. Use when asking about specific page health, comparing pages, or finding pages with performance issues.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

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

    Use free fullstory:discover_groups and fullstory:get_opportunity_stats for live signals.

    line 19
  2. Distinctive:

    If the user wants to know "mobile vs desktop on this page":

    line 52
  3. Distinctive:

    If a page stands out (high error rate, high abandonment):

    line 70
  4. Distinctive:

    When comparing pages, always normalize by traffic.

    line 105
  5. Distinctive:

    If a page has high error rate on a specific device/browser, flag it immediately — these are often easy-to-fix compatibility bugs.

    line 106
  6. Very specific:

    Always surface the metric_url for any page-level metric you build.

    line 108

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Page Performance

Analyze page-level health — load times, errors, device breakdown, and how users navigate between pages.

When to Use

  • "Which pages have the most errors?"
  • "How does /checkout perform on mobile vs desktop?"
  • "What pages do users visit before /pricing?"
  • "Show me sessions where /dashboard was slow to load"
  • "Which pages have the highest abandonment rate?"
  • "Compare all product pages by error rate"

Use free fullstory:discover_groups and fullstory:get_opportunity_stats for live signals. Discovery accepts one scope at a time (page_id, domain, app_name, segment_id, or funnel_id); use a segment for device/user filters and the live schema for time ranges. Use computed metrics for exact custom windows.

Workflow

Step 1: Define the scope

What does the user want to know about the page(s)?

  • Error rate: console errors, network failures on this page
  • Performance: rage clicks, dead clicks, form abandonment on this page
  • Navigation: what pages lead to/from this page
  • Device breakdown: mobile vs desktop usage and error rates
  • Comparison: rank multiple pages by a metric

Step 2: Build page-scoped metrics

For a single page, scope the metric to that page:

fullstory:build_metric(
  query="console errors on /checkout",
  output_type="trend"   # or single_number or top_n
)

For comparing multiple pages, use top_n grouped by page:

fullstory:build_metric(
  query="console errors by page",
  output_type="top_n"
)

Step 3: Add device/browser breakdown

If the user wants to know "mobile vs desktop on this page":

fullstory:build_metric(
  query="page views on /checkout by device type",
  output_type="top_n"
)

Or for errors specifically:

fullstory:build_metric(
  query="console errors on /checkout by device type",
  output_type="top_n"
)

Step 4: Investigate problem pages

If a page stands out (high error rate, high abandonment):

  1. fullstory:get_sessions(page="/checkout", metric_id=error_metric_id, limit=5)
  2. Load sessions through session-context agent: "What error occurred on /checkout? What page did the user come from and go to?"
  3. Synthesize: is the error specific to this page, or does it follow the user from a previous page?

Step 5: Navigation patterns

To understand what pages users visit before/after a given page:

fullstory:get_user_pages(uid="...", options={...})
→ returns all pages visited by a user in order

But this is per-user. For aggregate navigation patterns, build a funnel metric with the page as a step and compute:

fullstory:build_metric(
  query="users who viewed /pricing, then what page did they view next",
  output_type="top_n"
)

Common Analysis Patterns

QuestionApproach
"Which page has the most errors?"build_metric("console errors by page", "top_n") → compute
"How does /checkout perform on mobile?"build_metric("errors on /checkout by device", "top_n")
"What's the slowest page?"discover_groups for page-level rage clicks / abandonment
"What pages lead to /checkout?"Scan sessions that visited /checkout, note previous page
"Page X vs Page Y error rate"Two metrics, compute both, present side by side
"Has /settings gotten worse?"Trend metric for errors on /settings, look for inflection

Guidelines

  • Page names in Fullstory are URLs — use path patterns like /checkout or /products/*.
  • When comparing pages, always normalize by traffic. A page with 10 errors and 100 views is worse than a page with 50 errors and 10,000 views.
  • If a page has high error rate on a specific device/browser, flag it immediately — these are often easy-to-fix compatibility bugs.
  • Navigation pattern analysis is fuzzy — Fullstory doesn't have a native "page flow" tool. Be transparent that you're inferring from individual sessions, not getting a computed flow diagram.
  • Always surface the metric_url for any page-level metric you build.

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.