F5 Distributed Cloud Console Automation Skill

Expert in automating F5 Distributed Cloud web console operations through browser automation using the mcp__claude-in-chrome MCP tools.

Overview

This skill uses the mcp__claude-in-chrome__* MCP tools which integrate with the Claude in Chrome browser extension. These tools provide:

✅ Works with your existing browser session (preserves authentication)
✅ Provides real-time visual feedback (watch Claude navigate in real time)
✅ Uses natural language instructions (no low-level scripting required)
✅ Automatically handles existing login state and cookies
✅ Multi-provider authentication - detects Azure SSO, Google, Okta, SAML, and native login
✅ VPN detection - warns when tenant requires VPN access

MCP Tools Available

Tool	Purpose
`mcp__claude-in-chrome__tabs_context_mcp`	Get browser tab context
`mcp__claude-in-chrome__navigate`	Navigate to URLs
`mcp__claude-in-chrome__read_page`	Read page elements and structure
`mcp__claude-in-chrome__computer`	Click, type, screenshot, scroll
`mcp__claude-in-chrome__find`	Find elements by description
`mcp__claude-in-chrome__form_input`	Fill form fields
`mcp__claude-in-chrome__get_page_text`	Extract page text content

Prerequisites

Before using this skill, ensure you have:

1. Claude in Chrome Extension

Install from Chrome Web Store and verify connection:

# Visit Chrome Web Store and install "Claude in Chrome" extension
# Pin the extension to your toolbar for easy access

# Then verify the connection works:
claude --chrome

# In the Claude Code prompt, run:
/chrome

# You should see the connection status and options to enable by default

2. F5 XC API Credentials (for validation)

Set these environment variables for CLI-based verification:

export F5XC_API_URL="https://nferreira.staging.volterra.us"
export F5XC_API_TOKEN='2SiwIzdXcUTV9Kk/wURCJO+NPV8='

3. Authentication

You should already be logged into the F5 XC tenant in your Chrome browser. The skill leverages your existing session and handles authentication automatically if session expires.

Multi-Provider Authentication

This skill automatically detects and handles multiple authentication methods:

Auth Type	URL Pattern	Claude Can Automate?
Native U/P	`login*.volterra.us`	❌ User enters creds
Azure SSO	`login.microsoftonline.com`	⚠️ Only if cached
Google SSO	`accounts.google.com`	⚠️ Only if cached
Okta SSO	`*.okta.com`	⚠️ Only if cached
Generic SAML	`/saml/`, `/sso/`	⚠️ Only if cached
Already Logged In	`/web/workspaces/`	✅ Yes
Connection Failed	timeout/error	❌ Warn about VPN

Detection Triggers

The skill detects login requirements when:

URL redirects to login page (login*.volterra.us, login.microsoftonline.com, accounts.google.com, *.okta.com)
Page contains "Sign in", "Go to login", or "Session expired" messages
Connection times out (may require VPN)

Auto-Flow Sequence

1. Navigate to F5 XC tenant URL
2. Wait for page load (detect connection failures → warn about VPN)
3. Check URL and page content using mcp__claude-in-chrome__read_page
4. Identify authentication type:
   a. Native login → Inform user to enter credentials, wait
   b. SSO redirect → Find SSO button, click, wait for provider
   c. Already logged in → Skip to step 6
5. Handle SSO provider:
   - If cached session → auto-redirect back
   - If credentials needed → inform user, wait for confirmation
6. Verify F5 XC console loaded (look for workspace cards)
7. Continue with original navigation task

Login Example

/xc:console login https://nferreira.staging.volterra.us/ and navigate to WAAP

# Claude will:
# 1. Get browser context with tabs_context_mcp
# 2. Navigate to tenant URL
# 3. Detect auth type (native, SSO, or already logged in)
# 4. Handle accordingly (inform user or auto-complete)
# 5. Navigate to Web App and API Protection workspace
# 6. Take screenshot to confirm

See ./authentication-flows.md for detailed workflow steps.

Quick Start

Basic Navigation

# Launch Claude Code with Chrome integration
claude --chrome

# Then provide natural language instructions:
"Navigate to https://nferreira.staging.volterra.us and tell me what you see on the home page"

# Claude will:
# 1. Navigate to the URL
# 2. Wait for page to load
# 3. Take a screenshot
# 4. Describe what it sees

Form Filling

claude --chrome

"Navigate to the HTTP Load Balancers page at https://nferreira.staging.volterra.us.
Then click the 'Add HTTP Load Balancer' button.
Fill in the form with:
- Name: my-test-lb
- Namespace: production
- Domains: test.example.com

But stop before submitting - I want to review first."

Data Extraction

claude --chrome

"Navigate to the HTTP Load Balancers list page.
Extract all load balancer names, their namespaces, and domains.
Save the results as a JSON array."

Core Capabilities

Navigation

Navigate to any URL within the F5 XC console
Click menu items, buttons, and links using text or selectors
Switch between tabs and manage tab groups
Handle redirects automatically (including Azure SSO redirect)

Form Interaction

Fill text inputs, textareas
Select dropdown options
Check/uncheck checkboxes
Add/remove items from lists
Complete multi-step forms

Content Reading

Extract text content from pages
Read DOM structure and elements
Take screenshots for visual verification
Read console logs (useful for debugging)

Debugging

Inspect network requests (see API calls)
Read console errors and warnings
Analyze page structure
Verify element visibility and properties

Session Management

Automatically uses existing Chrome session
Preserves authentication state across providers (Azure, Google, Okta, SAML)
Handles session expiry with automatic auth type detection
Warns when VPN connection is required
Provides clear messages when manual authentication needed

Common Workflows

Workflow 1: Create HTTP Load Balancer

claude --chrome

"I want to create an HTTP load balancer in F5 XC.

Please:
1. Navigate to https://nferreira.staging.volterra.us
2. Find and click the 'HTTP Load Balancers' page
3. Click 'Add HTTP Load Balancer' button
4. Fill in:
   - Name: demo-lb
   - Namespace: production
   - Domains: demo.example.com
   - Protocol: HTTPS with Automatic Certificate
5. Look for an 'Origin Pool' field and let me know what options are available

Don't submit yet - just show me the form filled in."

Workflow 2: Explore Console Structure

claude --chrome

"Help me inventory the F5 Distributed Cloud console.

Navigate to https://nferreira.staging.volterra.us and:
1. Look at the main left sidebar menu
2. For each top-level menu item, tell me:
   - The menu item name
   - Any submenus
   - What page appears when clicked

Take screenshots of key pages so I can see the structure.
Organize the results as a hierarchical list."

Workflow 3: Verify with CLI Integration

# First, use the console to create something
claude --chrome

"Navigate to HTTP Load Balancers page and create a new LB named 'cli-test' in 'default' namespace.
Don't submit yet - just tell me the form is ready."

# Then verify with CLI
f5xcctl configuration list http_loadbalancer -n default

# You should see the newly created resource in the list

Advanced Patterns

Taking Screenshots for Reference

claude --chrome

"Navigate to the HTTP Load Balancers creation form and take a screenshot.
Save it so I can see the exact form layout and field names."

Handling Authentication Issues

When Claude encounters a login page, CAPTCHA, or other security challenge:

Claude will pause and describe what it sees
You manually handle the authentication (log in, solve CAPTCHA)
Tell Claude to continue with the task

claude --chrome

"Try to navigate to https://nferreira.staging.volterra.us"

# If you get: "I see a login page. Azure SSO button is visible."
# You manually click the SSO button or provide credentials in your browser
# Then tell Claude: "I've logged in, continue with the task"

Extracting Structured Data

claude --chrome

"Navigate to the HTTP Load Balancers list page.
For each load balancer shown, extract:
- Name
- Namespace
- Status
- Created date (if visible)

Format as a JSON array and save to lb-list.json"

Key Files in This Skill

File	Purpose
`SKILL.md`	This file - skill overview and instructions
`authentication-flows.md`	Multi-provider authentication handling (Azure, Google, Okta, SAML, native, VPN)
`console-navigation-metadata.json`	v2.2 metadata with stable selectors (data-testid, aria-label, text_match, css)
`url-sitemap.json`	Static/dynamic route mapping with workspace aliases and shortcuts
`crawl-workflow.md`	v2.2 crawl phases including selector and URL extraction
`scripts/crawl-console.js`	Crawler spec with extraction scripts and templates
`task-workflows.md`	Master index of task automation patterns
`documentation-index.md`	Indexed docs.cloud.f5.com knowledge base
`workflows/*.md`	Specific task workflows (HTTP LB, origin pools, WAF, etc.)

Documentation Integration

This skill is designed to work alongside official F5 XC documentation:

See documentation-index.md for links to docs.cloud.f5.com
Consult console-navigation-metadata.json for detailed form field information
Review workflows/ directory for step-by-step task guides

Integration with Other F5 XC Skills

This skill works seamlessly with:

f5xc-cli Skill (Query & Verify)

Use f5xcctl to validate console actions:

# After creating something in the console:
f5xcctl configuration get http_loadbalancer demo-lb -n production

# Compare what the console shows vs what the API returns

f5xc-terraform Skill (Infrastructure as Code)

Use Terraform to deploy the same resources as code:

# The console skill helps you:
# 1. Understand the UI workflow
# 2. See all available options
# 3. Learn the resource structure
# Then use f5xc-terraform to automate it

Best Practices

1. Break Large Tasks into Smaller Steps

# Instead of asking Claude to do everything in one go:
# ❌ "Create a complete load balancer with origin pool, health checks, and WAF policy"

# ✅ Do this in phases:
claude --chrome
# Phase 1: "Create origin pool named backend-pool"

# Phase 2: "Create HTTP LB named my-app pointing to backend-pool"

# Phase 3: "Add WAF policy to my-app LB"

2. Take Screenshots for Reference

claude --chrome

"Take screenshots of these pages and save them:
1. HTTP Load Balancers list page
2. HTTP Load Balancer creation form
3. Origin Pool creation form

I want to see the exact layout and field names."

3. Verify Console State with CLI

# After using console:
f5xcctl configuration list http_loadbalancer --all-namespaces --output-format json

# Compare with what console showed to ensure consistency

4. Be Specific with Instructions

# ❌ Too vague:
# "Create a load balancer"

# ✅ Specific:
# "Create HTTP load balancer named demo-lb in namespace 'production'
#  with domain example.com pointing to origin pool backend-pool.
#  Use HTTPS with automatic certificate."

Troubleshooting

Chrome Extension Not Connected

# 1. Verify extension is installed:
echo "Check Chrome Web Store for 'Claude in Chrome'"

# 2. Verify connection:
claude --chrome
/chrome

# 3. If not connected, reload the extension:
# - Go to chrome://extensions
# - Find "Claude in Chrome"
# - Click the reload icon

Session Expired

When Claude detects session expiry:

# Claude will identify the authentication type:
# - Native login (username/password): You'll be asked to enter credentials
# - SSO (Azure, Google, Okta): Claude attempts auto-login if cached
# - Connection timeout: Claude warns about VPN requirement
# After authenticating, tell Claude to continue

Form Fields Not Found

# Claude will describe what it sees
# Ask Claude to:
# 1. Take a screenshot
# 2. Describe all visible input fields
# 3. Look for the field by label text or placeholder

"Take a screenshot of the form.
Then find and fill the field labeled 'Domain' with 'example.com'."

Navigation Paths Changed

The console UI may change. If Claude can't find expected buttons:

# Claude will explore and find the new location
"The button location seems to have changed.
Explore the page and find the 'Create' or 'Add' button, then click it."

Security & Permissions

This skill operates within your existing Chrome browser session, so:

✅ Uses your existing SSO login (Azure, Google, Okta - no re-authentication if cached)
✅ Respects your browser's cookie storage and session state
✅ Cannot access other browser tabs or extensions
✅ Never enters credentials on your behalf (security policy)
⚠️ Can only interact with pages you have permission to access
⚠️ Should only be used with trusted instructions (avoid pasting untrusted prompts)

For sensitive operations:

Review Claude's actions before it submits forms
Use the preview/review step before final submission
Verify critical operations with f5xcctl CLI afterward

Getting Help

Debugging Claude's Navigation

claude --chrome

"I notice you took a wrong turn. Let me help.
Take a screenshot and describe what page you're on.
Then tell me what button or link you see that matches 'HTTP Load Balancers'."

Understanding Form Structure

claude --chrome

"Navigate to the form page and analyze its structure.
For each form field, tell me:
- The label text
- The input type (text, select, checkbox, etc.)
- Whether it's required
- Any visible validation hints"

Learning Console Workflows

claude --chrome

"Walk me through the steps to create an HTTP load balancer from scratch.
Assume I have:
- A namespace named 'production'
- An origin pool named 'backend-pool'

Show me each page I'd need to visit and what I'd fill in."

Deterministic Navigation (v2.2)

This skill uses pre-crawled metadata for deterministic browser automation. The plugin ships with pre-crawled metadata that works out of the box. Crawling is optional - use it to refresh stale data or update after F5 XC console UI changes.

Selector Priority Chain

The v2.2 metadata includes stable selectors that work across browser sessions, not just session-specific refs:

Priority	Selector Type	Reliability	Example
1	`data_testid`	Highest	`[data-testid="add-lb-btn"]`
2	`aria_label`	High	`[aria-label="Add Load Balancer"]`
3	`text_match`	Medium	Button containing "Add HTTP Load Balancer"
4	`css`	Medium	`.workspace-card:has-text('Web App')`
5	`ref`	Session-only	`ref_27` (requires fresh crawl)

How It Works

Before v2.2 (Session-Specific Refs):

Claude: Uses ref_27 from metadata
Risk: Refs change between browser sessions
Result: ~70% success rate

After v2.2 (Stable Selectors):

Claude: Uses data_testid > aria_label > text_match fallback
Uses: mcp__claude-in-chrome__find with stable selector
Result: ~95% success rate across sessions

Metadata Structure (v2.2)

Each element now includes both refs and stable selectors:

{
  "add_button": {
    "ref": "ref_27",
    "text": "Add HTTP Load Balancer",
    "selectors": {
      "data_testid": null,
      "aria_label": "Add HTTP Load Balancer",
      "text_match": "Add HTTP Load Balancer",
      "css": "button:has-text('Add HTTP Load Balancer')"
    }
  }
}

URL Sitemap

The url-sitemap.json file provides complete route mapping:

Static routes: Fixed paths like /web/home, /web/workspaces/...
Dynamic routes: Paths with variables like /namespaces/{namespace}/...
Workspace mapping: Shorthand aliases (waap → /web/workspaces/web-app-and-api-protection)
Resource shortcuts: Quick navigation (http-lb → full path with namespace variable)

Fallback Strategy

When navigating, Claude uses this priority:

Try data_testid selector (most stable)
Try aria_label selector
Try text_match with find()
Try css selector
Try session-specific ref (may be stale)
Report mismatch for metadata update

Crawl Command

To refresh the metadata (optional):

/xc:console crawl https://nferreira.staging.volterra.us/

See crawl-workflow.md for the detailed crawl process.

Current Status

Metadata v2.2.0:

✅ Skill directory structure created
✅ SKILL.md written with comprehensive instructions
✅ Multi-provider authentication (Azure, Google, Okta, SAML, native)
✅ VPN detection and warning
✅ Console crawl scripts with stable selector extraction
✅ Crawl workflow documented (crawl-workflow.md v2.2)
✅ URL sitemap with static/dynamic routes (url-sitemap.json)
✅ Stable selectors (data-testid, aria-label, text_match, css)
✅ Selector priority fallback chain
✅ Metadata ships with plugin (crawl is optional)

Next Steps

Run Initial Crawl
```
/xc:console crawl https://your-tenant.volterra.us/
```
Populate selectors for all elements across workspaces.
Validate Cross-Session Navigation Test deterministic navigation without refs (selectors only).

Validate with CLI

f5xcctl configuration list http_loadbalancer --all-namespaces

For detailed API-driven management: See the f5xc-cli and f5xc-terraform skills.

For console documentation mapping: See documentation-index.md (coming soon).

For specific task workflows: See workflows/ directory (coming soon).

xc-console