Fullstory Skills Repository (FSR)

A comprehensive collection of Agent Skills for expert-level Fullstory semantic decoration guidance.

🎯 What is FSR?

The Fullstory Skills Repository (FSR) is a structured collection of AI Agent Skills that provide expert-level guidance for Fullstory semantic decoration for digital experiences (FSD). FSD enables AI coding assistants to decorate digital experiences with semantic meaning. This exposes behavioral digital experience usage to Computer Use Agents and unlocks high fidelity analytic measurement directly in the DOM or mobile app view tree:

• Guide developers through API implementation with good/bad examples
• Apply industry-specific privacy requirements automatically
• Reference regulatory compliance patterns (HIPAA, PCI, GDPR, etc.)
• Recommend the right API for each use case

---

🆕 Latest Enhancements

Platform-Split Architecture (NEW)

All core skills and framework skills now use a three-file structure:

• SKILL.md — Platform-agnostic core concepts, API parameters, best practices (START HERE)
• SKILL-WEB.md — JavaScript/TypeScript implementation for web
• SKILL-MOBILE.md — iOS (Swift), Android (Kotlin), Flutter (Dart), React Native

Always read SKILL.md first for concepts, then the platform-specific file for implementation code.

SDK Installation vs API Usage

The skills repository covers API usage (how to identify users, track events, etc.). For SDK installation, see official Fullstory documentation:

• Web: Getting Started with Web
• Mobile: See meta/fullstory-getting-started/SKILL.md for links to all mobile platform installation guides

Mobile Instrumentation Orchestrator (NEW)

The new mobile-instrumentation-orchestrator skill provides sequencing logic for mobile SDK implementation:

• Privacy → Identity → Navigation → Interaction → Diagnostics
• Routes to appropriate SKILL-MOBILE.md files for each platform

Stable Selectors — Data Attributes Guide Convention

The stable selectors skill follows the Fullstory Data Attributes Guide convention with five core attributes:

• Web: data-component, data-id, data-section, data-position, data-state
• iOS: accessibilityIdentifier (dot notation: "button.add-to-cart")
• Android: testTag, contentDescription (dot notation)
• React Native: testID (dot notation)
• Flutter: Key, Semantics (dot notation)
• Mobile (all platforms): FS.setAttribute for setting data attributes programmatically

Two Approaches — agents ask users which they prefer:

• Framework Approach: Build data attributes into shared components (design system auto-decoration). Benefits: zero effort for consuming devs, consistent naming, scales automatically, resilient to refactors.