@athenaflow/plugin-site-knowledge 1.0.2

package/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "site-knowledge",
+  "description": "Site-specific automation patterns and knowledge for popular websites (Airbnb, Amazon, Apple Store)",
+  "version": "1.0.2",
+  "author": {
+    "name": "Athenaflow"
+  },
+  "keywords": [
+    "site-patterns",
+    "airbnb",
+    "amazon",
+    "apple",
+    "automation-knowledge"
+  ],
+  "category": "browser-automation"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "site-knowledge",
+  "version": "1.0.2",
+  "description": "Site-specific automation patterns and knowledge for popular websites (Airbnb, Amazon, Apple Store)",
+  "author": {
+    "name": "Athenaflow"
+  },
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Site Knowledge",
+    "shortDescription": "Automation patterns for popular websites",
+    "developerName": "Athenaflow",
+    "category": "Browser Automation"
+  }
+}

package/dist/1.0.2/.agents/plugins/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "name": "athena-workflow-marketplace",
+  "plugins": [
+    {
+      "name": "site-knowledge",
+      "version": "1.0.2",
+      "source": {
+        "source": "local",
+        "path": "./codex/plugin"
+      }
+    }
+  ]
+}

package/dist/1.0.2/claude/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "site-knowledge",
+  "description": "Site-specific automation patterns and knowledge for popular websites (Airbnb, Amazon, Apple Store)",
+  "version": "1.0.2",
+  "author": {
+    "name": "Athenaflow"
+  },
+  "keywords": [
+    "site-patterns",
+    "airbnb",
+    "amazon",
+    "apple",
+    "automation-knowledge"
+  ],
+  "category": "browser-automation"
+}

package/dist/1.0.2/claude/plugin/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@athenaflow/plugin-site-knowledge",
+  "version": "1.0.2",
+  "description": "Site-specific automation patterns and knowledge for popular websites (Airbnb, Amazon, Apple Store)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/dist/1.0.2/claude/plugin/skills/airbnb/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: airbnb
+description: >
+  Use when automating airbnb.com, searching for stays, browsing experiences, creating wishlists,
+  completing bookings, or writing tests for Airbnb flows. Covers site structure, search and booking
+  heuristics, and common Airbnb interaction patterns. Load live selectors from the browser; use the
+  bundled reference only for flow guidance and modal caveats.
+---
+
+# Airbnb Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/airbnb.md](references/airbnb.md) for Airbnb search, listing, filter, and modal heuristics.
+3. Treat all selectors in the reference as patterns, not guarantees. Derive the current `eid` and live selector from the page with `find`, `get_form`, and `get_element`.
+4. Re-check page state after search, filter changes, or modal dismissal because Airbnb frequently re-renders key controls.
+5. Before any booking or sign-in step, confirm dates, guest counts, listing identity, and total price with the user.

package/dist/1.0.2/claude/plugin/skills/airbnb/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/dist/1.0.2/claude/plugin/skills/airbnb/references/airbnb.md

@@ -0,0 +1,58 @@
+# Airbnb Reference
+
+Use this file for Airbnb-specific heuristics after loading `agent-web-interface-guide`. Do not rely on exact selectors; Airbnb frequently re-renders controls and varies by locale and experiment bucket.
+
+## URL Patterns
+
+- Home: `https://www.airbnb.com`
+- Search results: `https://www.airbnb.com/s/<location>/homes`
+- Listing detail: `https://www.airbnb.com/rooms/<id>`
+- Experiences: `https://www.airbnb.com/experiences`
+
+## Search Heuristics
+
+Typical search flow:
+
+1. Choose location
+2. Choose check-in and check-out dates
+3. Choose guests
+4. Submit search
+
+Airbnb may collapse the search UI into progressive steps, a modal, or a sticky header variant. Re-read the page after each step.
+
+## Results Heuristics
+
+- Results may be infinite-scroll or paginated with `Show more`.
+- Filters often open as modals or drawers rather than inline controls.
+- Listing cards usually expose title, price, rating, and save/heart actions.
+- Map/list toggles can re-layout the page substantially.
+
+## Listing Heuristics
+
+Before any reserve action, verify:
+
+- Listing identity
+- Dates
+- Guest count
+- Nightly price
+- Full price breakdown including fees
+- Cancellation policy when relevant
+
+## Modal And Prompt Heuristics
+
+Common interruptions:
+
+- Cookie consent
+- Login or sign-up prompt
+- Translation prompt
+- Date or guest picker overlays
+
+Dismiss or resolve them explicitly, then snapshot again before continuing.
+
+## Common Failure Modes
+
+- Search controls re-rendering and invalidating stale element IDs
+- Date selection not persisting when the modal closes
+- Guest counts resetting after filter changes
+- Price mismatch between results card and final booking breakdown
+- Hidden fees only appearing deeper in the booking flow

package/dist/1.0.2/claude/plugin/skills/amazon/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: amazon
+description: >
+  Use when automating amazon.com, searching for products, adding items to cart, browsing deals,
+  navigating product pages, or writing tests for Amazon shopping flows. Covers site structure,
+  search/buying heuristics, and common Amazon interaction patterns. Load live selectors from the
+  browser; use the bundled reference only for flow guidance and site-specific caveats.
+---
+
+# Amazon Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/amazon.md](references/amazon.md) for Amazon search, product, cart, and modal heuristics.
+3. Treat all selectors in the reference as starting patterns only. Derive the current `eid` and live selector from the page with `find`, `get_form`, and `get_element`.
+4. Expect Amazon to vary by seller, region, stock state, and experiment bucket. Re-evaluate the flow after every navigation or modal open.
+5. Before checkout or sign-in, confirm the intended product, seller, quantity, and total with the user.

package/dist/1.0.2/claude/plugin/skills/amazon/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/dist/1.0.2/claude/plugin/skills/amazon/references/amazon.md

@@ -0,0 +1,62 @@
+# Amazon Reference
+
+Use this file for Amazon-specific heuristics after loading `agent-web-interface-guide`. Do not rely on exact selectors; Amazon frequently changes labels, placement, and region-specific chrome.
+
+## URL Patterns
+
+- Home: `https://www.amazon.com`
+- Search results: `https://www.amazon.com/s?k=<query>`
+- Product detail: `https://www.amazon.com/<slug>/dp/<asin>`
+- Cart: `https://www.amazon.com/gp/cart/view.html`
+
+## Search Heuristics
+
+- Prefer precise product queries over broad ones.
+- Sponsored results often appear above the best organic match.
+- Related-search links can narrow ambiguous results faster than refining the query manually.
+- Autocomplete suggestions may not be directly targetable; pressing Enter is often more reliable.
+
+## Product Page Heuristics
+
+- Some products expose a direct `Add to Cart`.
+- Others route through `See All Buying Options`, especially when multiple sellers compete or stock is constrained.
+- Seller, condition, shipping speed, and region can change what controls are visible.
+- The first prominent purchase control is not always the cheapest or intended seller option.
+
+## Buying Options Heuristics
+
+When `Add to Cart` is absent:
+
+1. Open the buying options surface
+2. Compare seller, condition, and price
+3. Pick the intended seller explicitly
+4. Re-check the resulting cart page for the actual seller and item configuration
+
+## Cart Verification
+
+Confirm:
+
+- Product title
+- Seller when relevant
+- Quantity
+- Price per item
+- Subtotal
+
+Do not trust search-result price text as final cart price. Amazon often changes price or seller between results and checkout surfaces.
+
+## Common Modals And Interruptions
+
+- Region or locale prompt
+- Sign-in prompt
+- Protection plan or add-on upsell
+- Buying options drawer or modal
+
+Dismiss or resolve these explicitly before continuing.
+
+## Common Failure Modes
+
+- Search results polluted by accessories or competing products
+- Sponsored result chosen accidentally
+- Wrong seller added through buying options
+- Region-specific currency or shipping state confusing comparisons
+- Cart page showing bundle, protection plan, or add-on that was added during the flow

package/dist/1.0.2/claude/plugin/skills/apple-store/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: apple-store
+description: >
+  Use when automating apple.com, configuring iPhones or other Apple products, navigating the Apple
+  Store, adding items to bag, or writing tests for Apple Store flows. Covers site structure, purchase
+  flows, bag behavior, and Apple-specific interaction patterns. Load live selectors from the browser;
+  use the bundled reference only for site heuristics and flow guidance.
+---
+
+# Apple Store Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/apple-store.md](references/apple-store.md) for Apple Store navigation, flow order, and bag heuristics.
+3. Treat selectors in the reference as patterns, not guarantees. Derive the current `eid` and best live selector from the page with `find`, `get_form`, and `get_element`.
+4. Re-check the page after each configuration step because Apple often enables downstream options only after prerequisites are selected.
+5. Before any checkout or order placement step, confirm the final configuration and total with the user.

package/dist/1.0.2/claude/plugin/skills/apple-store/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/dist/1.0.2/claude/plugin/skills/apple-store/references/apple-store.md

@@ -0,0 +1,67 @@
+# Apple Store Reference
+
+Use this file for Apple Store heuristics after loading `agent-web-interface-guide`. Do not assume exact selectors remain stable across sessions; resolve live elements from the page before acting.
+
+## URL Patterns
+
+- Store home: `/store`
+- Product listing: `/shop/buy-{product}`
+- Product configurator: `/shop/buy-{product}/{model}`
+- Bag: `/shop/bag`
+- Checkout: `/shop/checkout`
+
+## Common Flow Shape
+
+Apple purchase flows are usually sequential. Later choices often remain disabled until earlier choices are selected.
+
+Typical order:
+
+1. Select model or base configuration
+2. Select color
+3. Select storage or memory
+4. Select carrier or connectivity options when applicable
+5. Select trade-in or no trade-in
+6. Select AppleCare option or no coverage
+7. Add to bag
+8. Review optional accessories page
+9. Open bag and verify contents
+
+## Page Heuristics
+
+- Store landing pages often expose direct `Buy` links for each product family.
+- Product grids usually show a product heading, a price text node like `From $...`, and a `Buy` link.
+- Configurator choices usually surface as radio groups.
+- Bag controls may render as links, buttons, or comboboxes depending on the page and experiment bucket. Derive them live.
+
+## What To Verify At Each Step
+
+- The newly selected option is marked selected or checked.
+- The next section becomes enabled after the prerequisite selection.
+- The configured price updates when storage, memory, or purchase option changes.
+- The add-to-bag control becomes enabled before clicking.
+
+## Common Optional Gates
+
+- Trade-in prompts: choose explicit no-trade-in when the user did not ask for trade-in.
+- AppleCare prompts: choose explicit no-coverage when the user did not ask for coverage.
+- Accessory upsells: Apple often inserts a post-add accessory page with a `Review Bag` button.
+
+## Bag Verification
+
+Confirm:
+
+- Product name
+- Full configuration
+- Quantity
+- Unit price
+- Bag total
+
+Do not infer quantity from total alone when multiple items may already be in the bag. Read the quantity control directly if present.
+
+## Common Failure Modes
+
+- Add-to-bag disabled because a required radio group remains unanswered
+- Option unavailable or incompatible with a previous choice
+- Price lagging behind selection because the page has not re-rendered yet
+- Existing bag contents making totals misleading
+- Accessory interstitial mistaken for final confirmation

package/dist/1.0.2/codex/plugin/.codex-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "site-knowledge",
+  "version": "1.0.2",
+  "description": "Site-specific automation patterns and knowledge for popular websites (Airbnb, Amazon, Apple Store)",
+  "author": {
+    "name": "Athenaflow"
+  },
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Site Knowledge",
+    "shortDescription": "Automation patterns for popular websites",
+    "developerName": "Athenaflow",
+    "category": "Browser Automation"
+  }
+}

package/dist/1.0.2/codex/plugin/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@athenaflow/plugin-site-knowledge",
+  "version": "1.0.2",
+  "description": "Site-specific automation patterns and knowledge for popular websites (Airbnb, Amazon, Apple Store)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/dist/1.0.2/codex/plugin/skills/airbnb/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: airbnb
+description: >
+  Use when automating airbnb.com, searching for stays, browsing experiences, creating wishlists,
+  completing bookings, or writing tests for Airbnb flows. Covers site structure, search and booking
+  heuristics, and common Airbnb interaction patterns. Load live selectors from the browser; use the
+  bundled reference only for flow guidance and modal caveats.
+---
+
+# Airbnb Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/airbnb.md](references/airbnb.md) for Airbnb search, listing, filter, and modal heuristics.
+3. Treat all selectors in the reference as patterns, not guarantees. Derive the current `eid` and live selector from the page with `find`, `get_form`, and `get_element`.
+4. Re-check page state after search, filter changes, or modal dismissal because Airbnb frequently re-renders key controls.
+5. Before any booking or sign-in step, confirm dates, guest counts, listing identity, and total price with the user.

package/dist/1.0.2/codex/plugin/skills/airbnb/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/dist/1.0.2/codex/plugin/skills/airbnb/references/airbnb.md

@@ -0,0 +1,58 @@
+# Airbnb Reference
+
+Use this file for Airbnb-specific heuristics after loading `agent-web-interface-guide`. Do not rely on exact selectors; Airbnb frequently re-renders controls and varies by locale and experiment bucket.
+
+## URL Patterns
+
+- Home: `https://www.airbnb.com`
+- Search results: `https://www.airbnb.com/s/<location>/homes`
+- Listing detail: `https://www.airbnb.com/rooms/<id>`
+- Experiences: `https://www.airbnb.com/experiences`
+
+## Search Heuristics
+
+Typical search flow:
+
+1. Choose location
+2. Choose check-in and check-out dates
+3. Choose guests
+4. Submit search
+
+Airbnb may collapse the search UI into progressive steps, a modal, or a sticky header variant. Re-read the page after each step.
+
+## Results Heuristics
+
+- Results may be infinite-scroll or paginated with `Show more`.
+- Filters often open as modals or drawers rather than inline controls.
+- Listing cards usually expose title, price, rating, and save/heart actions.
+- Map/list toggles can re-layout the page substantially.
+
+## Listing Heuristics
+
+Before any reserve action, verify:
+
+- Listing identity
+- Dates
+- Guest count
+- Nightly price
+- Full price breakdown including fees
+- Cancellation policy when relevant
+
+## Modal And Prompt Heuristics
+
+Common interruptions:
+
+- Cookie consent
+- Login or sign-up prompt
+- Translation prompt
+- Date or guest picker overlays
+
+Dismiss or resolve them explicitly, then snapshot again before continuing.
+
+## Common Failure Modes
+
+- Search controls re-rendering and invalidating stale element IDs
+- Date selection not persisting when the modal closes
+- Guest counts resetting after filter changes
+- Price mismatch between results card and final booking breakdown
+- Hidden fees only appearing deeper in the booking flow

package/dist/1.0.2/codex/plugin/skills/amazon/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: amazon
+description: >
+  Use when automating amazon.com, searching for products, adding items to cart, browsing deals,
+  navigating product pages, or writing tests for Amazon shopping flows. Covers site structure,
+  search/buying heuristics, and common Amazon interaction patterns. Load live selectors from the
+  browser; use the bundled reference only for flow guidance and site-specific caveats.
+---
+
+# Amazon Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/amazon.md](references/amazon.md) for Amazon search, product, cart, and modal heuristics.
+3. Treat all selectors in the reference as starting patterns only. Derive the current `eid` and live selector from the page with `find`, `get_form`, and `get_element`.
+4. Expect Amazon to vary by seller, region, stock state, and experiment bucket. Re-evaluate the flow after every navigation or modal open.
+5. Before checkout or sign-in, confirm the intended product, seller, quantity, and total with the user.

package/dist/1.0.2/codex/plugin/skills/amazon/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/dist/1.0.2/codex/plugin/skills/amazon/references/amazon.md

@@ -0,0 +1,62 @@
+# Amazon Reference
+
+Use this file for Amazon-specific heuristics after loading `agent-web-interface-guide`. Do not rely on exact selectors; Amazon frequently changes labels, placement, and region-specific chrome.
+
+## URL Patterns
+
+- Home: `https://www.amazon.com`
+- Search results: `https://www.amazon.com/s?k=<query>`
+- Product detail: `https://www.amazon.com/<slug>/dp/<asin>`
+- Cart: `https://www.amazon.com/gp/cart/view.html`
+
+## Search Heuristics
+
+- Prefer precise product queries over broad ones.
+- Sponsored results often appear above the best organic match.
+- Related-search links can narrow ambiguous results faster than refining the query manually.
+- Autocomplete suggestions may not be directly targetable; pressing Enter is often more reliable.
+
+## Product Page Heuristics
+
+- Some products expose a direct `Add to Cart`.
+- Others route through `See All Buying Options`, especially when multiple sellers compete or stock is constrained.
+- Seller, condition, shipping speed, and region can change what controls are visible.
+- The first prominent purchase control is not always the cheapest or intended seller option.
+
+## Buying Options Heuristics
+
+When `Add to Cart` is absent:
+
+1. Open the buying options surface
+2. Compare seller, condition, and price
+3. Pick the intended seller explicitly
+4. Re-check the resulting cart page for the actual seller and item configuration
+
+## Cart Verification
+
+Confirm:
+
+- Product title
+- Seller when relevant
+- Quantity
+- Price per item
+- Subtotal
+
+Do not trust search-result price text as final cart price. Amazon often changes price or seller between results and checkout surfaces.
+
+## Common Modals And Interruptions
+
+- Region or locale prompt
+- Sign-in prompt
+- Protection plan or add-on upsell
+- Buying options drawer or modal
+
+Dismiss or resolve these explicitly before continuing.
+
+## Common Failure Modes
+
+- Search results polluted by accessories or competing products
+- Sponsored result chosen accidentally
+- Wrong seller added through buying options
+- Region-specific currency or shipping state confusing comparisons
+- Cart page showing bundle, protection plan, or add-on that was added during the flow

package/dist/1.0.2/codex/plugin/skills/apple-store/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: apple-store
+description: >
+  Use when automating apple.com, configuring iPhones or other Apple products, navigating the Apple
+  Store, adding items to bag, or writing tests for Apple Store flows. Covers site structure, purchase
+  flows, bag behavior, and Apple-specific interaction patterns. Load live selectors from the browser;
+  use the bundled reference only for site heuristics and flow guidance.
+---
+
+# Apple Store Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/apple-store.md](references/apple-store.md) for Apple Store navigation, flow order, and bag heuristics.
+3. Treat selectors in the reference as patterns, not guarantees. Derive the current `eid` and best live selector from the page with `find`, `get_form`, and `get_element`.
+4. Re-check the page after each configuration step because Apple often enables downstream options only after prerequisites are selected.
+5. Before any checkout or order placement step, confirm the final configuration and total with the user.

package/dist/1.0.2/codex/plugin/skills/apple-store/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/dist/1.0.2/codex/plugin/skills/apple-store/references/apple-store.md

@@ -0,0 +1,67 @@
+# Apple Store Reference
+
+Use this file for Apple Store heuristics after loading `agent-web-interface-guide`. Do not assume exact selectors remain stable across sessions; resolve live elements from the page before acting.
+
+## URL Patterns
+
+- Store home: `/store`
+- Product listing: `/shop/buy-{product}`
+- Product configurator: `/shop/buy-{product}/{model}`
+- Bag: `/shop/bag`
+- Checkout: `/shop/checkout`
+
+## Common Flow Shape
+
+Apple purchase flows are usually sequential. Later choices often remain disabled until earlier choices are selected.
+
+Typical order:
+
+1. Select model or base configuration
+2. Select color
+3. Select storage or memory
+4. Select carrier or connectivity options when applicable
+5. Select trade-in or no trade-in
+6. Select AppleCare option or no coverage
+7. Add to bag
+8. Review optional accessories page
+9. Open bag and verify contents
+
+## Page Heuristics
+
+- Store landing pages often expose direct `Buy` links for each product family.
+- Product grids usually show a product heading, a price text node like `From $...`, and a `Buy` link.
+- Configurator choices usually surface as radio groups.
+- Bag controls may render as links, buttons, or comboboxes depending on the page and experiment bucket. Derive them live.
+
+## What To Verify At Each Step
+
+- The newly selected option is marked selected or checked.
+- The next section becomes enabled after the prerequisite selection.
+- The configured price updates when storage, memory, or purchase option changes.
+- The add-to-bag control becomes enabled before clicking.
+
+## Common Optional Gates
+
+- Trade-in prompts: choose explicit no-trade-in when the user did not ask for trade-in.
+- AppleCare prompts: choose explicit no-coverage when the user did not ask for coverage.
+- Accessory upsells: Apple often inserts a post-add accessory page with a `Review Bag` button.
+
+## Bag Verification
+
+Confirm:
+
+- Product name
+- Full configuration
+- Quantity
+- Unit price
+- Bag total
+
+Do not infer quantity from total alone when multiple items may already be in the bag. Read the quantity control directly if present.
+
+## Common Failure Modes
+
+- Add-to-bag disabled because a required radio group remains unanswered
+- Option unavailable or incompatible with a previous choice
+- Price lagging behind selection because the page has not re-rendered yet
+- Existing bag contents making totals misleading
+- Accessory interstitial mistaken for final confirmation

package/dist/1.0.2/release.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": 1,
+  "pluginRef": "site-knowledge@athena-workflow-marketplace",
+  "pluginName": "site-knowledge",
+  "marketplaceName": "athena-workflow-marketplace",
+  "version": "1.0.2",
+  "artifacts": {
+    "claude": {
+      "type": "directory",
+      "path": "./claude/plugin"
+    },
+    "codex": {
+      "type": "marketplace",
+      "marketplacePath": "./.agents/plugins/marketplace.json",
+      "pluginPath": "./codex/plugin"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@athenaflow/plugin-site-knowledge",
+  "version": "1.0.2",
+  "description": "Site-specific automation patterns and knowledge for popular websites (Airbnb, Amazon, Apple Store)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build:artifacts": "node ../../scripts/build-plugin-artifacts.mjs .",
+    "prepack": "npm run build:artifacts"
+  }
+}

package/skills/airbnb/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: airbnb
+description: >
+  Use when automating airbnb.com, searching for stays, browsing experiences, creating wishlists,
+  completing bookings, or writing tests for Airbnb flows. Covers site structure, search and booking
+  heuristics, and common Airbnb interaction patterns. Load live selectors from the browser; use the
+  bundled reference only for flow guidance and modal caveats.
+---
+
+# Airbnb Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/airbnb.md](references/airbnb.md) for Airbnb search, listing, filter, and modal heuristics.
+3. Treat all selectors in the reference as patterns, not guarantees. Derive the current `eid` and live selector from the page with `find`, `get_form`, and `get_element`.
+4. Re-check page state after search, filter changes, or modal dismissal because Airbnb frequently re-renders key controls.
+5. Before any booking or sign-in step, confirm dates, guest counts, listing identity, and total price with the user.

package/skills/airbnb/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/skills/airbnb/references/airbnb.md

@@ -0,0 +1,58 @@
+# Airbnb Reference
+
+Use this file for Airbnb-specific heuristics after loading `agent-web-interface-guide`. Do not rely on exact selectors; Airbnb frequently re-renders controls and varies by locale and experiment bucket.
+
+## URL Patterns
+
+- Home: `https://www.airbnb.com`
+- Search results: `https://www.airbnb.com/s/<location>/homes`
+- Listing detail: `https://www.airbnb.com/rooms/<id>`
+- Experiences: `https://www.airbnb.com/experiences`
+
+## Search Heuristics
+
+Typical search flow:
+
+1. Choose location
+2. Choose check-in and check-out dates
+3. Choose guests
+4. Submit search
+
+Airbnb may collapse the search UI into progressive steps, a modal, or a sticky header variant. Re-read the page after each step.
+
+## Results Heuristics
+
+- Results may be infinite-scroll or paginated with `Show more`.
+- Filters often open as modals or drawers rather than inline controls.
+- Listing cards usually expose title, price, rating, and save/heart actions.
+- Map/list toggles can re-layout the page substantially.
+
+## Listing Heuristics
+
+Before any reserve action, verify:
+
+- Listing identity
+- Dates
+- Guest count
+- Nightly price
+- Full price breakdown including fees
+- Cancellation policy when relevant
+
+## Modal And Prompt Heuristics
+
+Common interruptions:
+
+- Cookie consent
+- Login or sign-up prompt
+- Translation prompt
+- Date or guest picker overlays
+
+Dismiss or resolve them explicitly, then snapshot again before continuing.
+
+## Common Failure Modes
+
+- Search controls re-rendering and invalidating stale element IDs
+- Date selection not persisting when the modal closes
+- Guest counts resetting after filter changes
+- Price mismatch between results card and final booking breakdown
+- Hidden fees only appearing deeper in the booking flow

package/skills/amazon/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: amazon
+description: >
+  Use when automating amazon.com, searching for products, adding items to cart, browsing deals,
+  navigating product pages, or writing tests for Amazon shopping flows. Covers site structure,
+  search/buying heuristics, and common Amazon interaction patterns. Load live selectors from the
+  browser; use the bundled reference only for flow guidance and site-specific caveats.
+---
+
+# Amazon Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/amazon.md](references/amazon.md) for Amazon search, product, cart, and modal heuristics.
+3. Treat all selectors in the reference as starting patterns only. Derive the current `eid` and live selector from the page with `find`, `get_form`, and `get_element`.
+4. Expect Amazon to vary by seller, region, stock state, and experiment bucket. Re-evaluate the flow after every navigation or modal open.
+5. Before checkout or sign-in, confirm the intended product, seller, quantity, and total with the user.

package/skills/amazon/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/skills/amazon/references/amazon.md

@@ -0,0 +1,62 @@
+# Amazon Reference
+
+Use this file for Amazon-specific heuristics after loading `agent-web-interface-guide`. Do not rely on exact selectors; Amazon frequently changes labels, placement, and region-specific chrome.
+
+## URL Patterns
+
+- Home: `https://www.amazon.com`
+- Search results: `https://www.amazon.com/s?k=<query>`
+- Product detail: `https://www.amazon.com/<slug>/dp/<asin>`
+- Cart: `https://www.amazon.com/gp/cart/view.html`
+
+## Search Heuristics
+
+- Prefer precise product queries over broad ones.
+- Sponsored results often appear above the best organic match.
+- Related-search links can narrow ambiguous results faster than refining the query manually.
+- Autocomplete suggestions may not be directly targetable; pressing Enter is often more reliable.
+
+## Product Page Heuristics
+
+- Some products expose a direct `Add to Cart`.
+- Others route through `See All Buying Options`, especially when multiple sellers compete or stock is constrained.
+- Seller, condition, shipping speed, and region can change what controls are visible.
+- The first prominent purchase control is not always the cheapest or intended seller option.
+
+## Buying Options Heuristics
+
+When `Add to Cart` is absent:
+
+1. Open the buying options surface
+2. Compare seller, condition, and price
+3. Pick the intended seller explicitly
+4. Re-check the resulting cart page for the actual seller and item configuration
+
+## Cart Verification
+
+Confirm:
+
+- Product title
+- Seller when relevant
+- Quantity
+- Price per item
+- Subtotal
+
+Do not trust search-result price text as final cart price. Amazon often changes price or seller between results and checkout surfaces.
+
+## Common Modals And Interruptions
+
+- Region or locale prompt
+- Sign-in prompt
+- Protection plan or add-on upsell
+- Buying options drawer or modal
+
+Dismiss or resolve these explicitly before continuing.
+
+## Common Failure Modes
+
+- Search results polluted by accessories or competing products
+- Sponsored result chosen accidentally
+- Wrong seller added through buying options
+- Region-specific currency or shipping state confusing comparisons
+- Cart page showing bundle, protection plan, or add-on that was added during the flow

package/skills/apple-store/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: apple-store
+description: >
+  Use when automating apple.com, configuring iPhones or other Apple products, navigating the Apple
+  Store, adding items to bag, or writing tests for Apple Store flows. Covers site structure, purchase
+  flows, bag behavior, and Apple-specific interaction patterns. Load live selectors from the browser;
+  use the bundled reference only for site heuristics and flow guidance.
+---
+
+# Apple Store Automation Skill
+
+This skill is a thin router. Use it together with `agent-web-interface-guide` for live browser work.
+
+## Workflow
+
+1. Load `agent-web-interface-guide` before using browser MCP tools.
+2. Read [references/apple-store.md](references/apple-store.md) for Apple Store navigation, flow order, and bag heuristics.
+3. Treat selectors in the reference as patterns, not guarantees. Derive the current `eid` and best live selector from the page with `find`, `get_form`, and `get_element`.
+4. Re-check the page after each configuration step because Apple often enables downstream options only after prerequisites are selected.
+5. Before any checkout or order placement step, confirm the final configuration and total with the user.

package/skills/apple-store/agents/claude.yaml

@@ -0,0 +1,2 @@
+frontmatter:
+  user-invocable: false

package/skills/apple-store/references/apple-store.md

@@ -0,0 +1,67 @@
+# Apple Store Reference
+
+Use this file for Apple Store heuristics after loading `agent-web-interface-guide`. Do not assume exact selectors remain stable across sessions; resolve live elements from the page before acting.
+
+## URL Patterns
+
+- Store home: `/store`
+- Product listing: `/shop/buy-{product}`
+- Product configurator: `/shop/buy-{product}/{model}`
+- Bag: `/shop/bag`
+- Checkout: `/shop/checkout`
+
+## Common Flow Shape
+
+Apple purchase flows are usually sequential. Later choices often remain disabled until earlier choices are selected.
+
+Typical order:
+
+1. Select model or base configuration
+2. Select color
+3. Select storage or memory
+4. Select carrier or connectivity options when applicable
+5. Select trade-in or no trade-in
+6. Select AppleCare option or no coverage
+7. Add to bag
+8. Review optional accessories page
+9. Open bag and verify contents
+
+## Page Heuristics
+
+- Store landing pages often expose direct `Buy` links for each product family.
+- Product grids usually show a product heading, a price text node like `From $...`, and a `Buy` link.
+- Configurator choices usually surface as radio groups.
+- Bag controls may render as links, buttons, or comboboxes depending on the page and experiment bucket. Derive them live.
+
+## What To Verify At Each Step
+
+- The newly selected option is marked selected or checked.
+- The next section becomes enabled after the prerequisite selection.
+- The configured price updates when storage, memory, or purchase option changes.
+- The add-to-bag control becomes enabled before clicking.
+
+## Common Optional Gates
+
+- Trade-in prompts: choose explicit no-trade-in when the user did not ask for trade-in.
+- AppleCare prompts: choose explicit no-coverage when the user did not ask for coverage.
+- Accessory upsells: Apple often inserts a post-add accessory page with a `Review Bag` button.
+
+## Bag Verification
+
+Confirm:
+
+- Product name
+- Full configuration
+- Quantity
+- Unit price
+- Bag total
+
+Do not infer quantity from total alone when multiple items may already be in the bag. Read the quantity control directly if present.
+
+## Common Failure Modes
+
+- Add-to-bag disabled because a required radio group remains unanswered
+- Option unavailable or incompatible with a previous choice
+- Price lagging behind selection because the page has not re-rendered yet
+- Existing bag contents making totals misleading
+- Accessory interstitial mistaken for final confirmation