skills.rest
potentialInc
potentialIncOFFICIAL
Explore all skills by this author →
WebsiteGitHub

story-generation

Crawl Android and iOS app UIs via Appium to generate YAML user stories and screen maps.

Updated Aug 27, 2026
Search Tags:#user-stories#story-generation#appium#qa-testing#mobile-automation#screen-mapping#app-crawl
One-click install
npx skills add https://github.com/potentialInc/claude-mobile --skill story-generation-potentialinc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: story-generation
Source: https://github.com/potentialInc/claude-mobile/tree/main/story-generation
Command: npx skills add https://github.com/potentialInc/claude-mobile --skill story-generation-potentialinc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually exploring a mobile app to discover screens, inventory UI elements, and write structured QA user stories is slow, error-prone, and hard to scale across devices and platforms. This Skill automates discovery and story generation so teams can rapidly produce consistent YAML test artifacts and screen maps without manual screen-by-screen authoring.

Core Features & Use Cases

  • Cross-platform crawl: Orchestrates Appium sessions on Android and iOS to capture page_source and screenshots for each screen discovered.
  • Element inventory & signatures: Produces structured element metadata (type, identifier, text, state, bounds) and deduplicates screens via stable signatures.
  • Automated story generation: Emits tiered YAML user stories (smoke, interaction, validation, navigation, toggle) and a SCREEN_MAP with navigation graph and screenshots.
  • Use Case: Generate a regression test suite for a mobile app by crawling the app on a connected device and outputting ready-to-run YAML stories for QA pipelines.

Quick Start

Generate user stories for com.example.app/.MainActivity on my connected Android device and save them to ./generated-stories/example-app/.

Frequently Asked Questions about story-generation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate QA user stories from a mobile app UI?▼

You can generate QA user stories by auto-crawling a mobile app UI with Appium sessions to discover screens, inventory elements, and output structured YAML test artifacts. This automates story generation to produce consistent smoke, interaction, and validation stories.

Can I use Appium to crawl both Android and iOS apps for test generation?▼

Yes, Appium supports crawling both Android and iOS apps for test generation. The crawler orchestrates platform-specific Appium sessions to capture page_source and screenshots, deduplicating screens via stable signatures to build a navigation graph.

What is automated screen mapping for mobile apps?▼

Automated screen mapping for mobile apps is the process of crawling UI screens to capture element metadata and deduplicate screens via stable signatures. It produces a SCREEN_MAP containing a navigation graph and screenshots to map the app's structure.

Do I need a connected device to auto-crawl an app and generate YAML stories?▼

Yes, you need a connected device or emulator to auto-crawl an app and generate YAML stories. The process requires active Appium sessions with appropriate drivers to capture page_source and screenshots directly from the mobile environment.

What types of YAML user stories are generated from an app crawl?▼

The app crawl generates tiered YAML user stories categorized as smoke, interaction, validation, navigation, and toggle tests. These ready-to-run artifacts are output alongside a screen map for immediate use in QA pipelines.

Related Skills

Explore More Software Engineering Skills→
pacphipacphi
6

mobile-testing

Automate mobile app QA across iOS and Android with Appium.

Community
Advanced
DemolinatorDemolinator
2

Playwright Workflow Tester

Automate end-to-end web application tests with Playwright and generate markdown reports.

Community
Advanced
bflandevbflandev
1

component-inventory

Derive a reusable UI component library from a screen inventory.

Community
Intermediate
asnar00asnar00
1

iphone-screen-capture

Mirror a connected iPhone's screen on macOS via a Swift app.

Community
Advanced