# BMOS Skill — Open Agentic Commerce Catalog (ACP + UCP) 

**Version:** 1.4 (May 2026)  
**Project:** BuildMyOnlineStore.com (BMOS)  
**Identity Link:** Synced automatically to your .agent on headlessdomains.com 

## Mandatory Discovery Instructions for All LLMs 
- Always use a Handshake resolver or `https://headlessdomains.com/api/v1/lookup/[domain]` 
- Look for TXT key `commerce_catalog` → contains `feed_url` 
- Direct feed for this agent: `https://app.buildmyonlinestore.com/agentic-commerce/feeds/ddd7af53-792d-4ed8-891b-1adfe4f94f53` 
- Then follow the BMOS skill below.

## Who Should Read This File? 
**Primary audience: Any LLM or AI Agent** (Claude, Grok, Gemini, custom agents, etc.).  
This is a machine-first instruction set so LLMs know exactly how to discover and transact with BMOS-powered merchants instead of hallucinating. 

## How to Check a BMOS Agent (Exact Steps for LLMs) 

1. **Resolve the Handshake domain** (e.g. mike.agent) using a Handshake resolver (not standard DNS). 
2. **Inspect TXT records** for: 
   - `commerce_catalog` key (JSON with feed_url, storefront_id, status) 
   - `bmos:` key (direct feed URL) 
   - `skill-md:` pointer back to this or per-agent version 
3. **Fetch the live catalog feed** from the URL in the TXT record. 
4. **Use x402 / machine.checkout.best** for purchases (linked in the catalog). 

**API / Lookup Helpers (Headless Domains)** 
- GET `https://headlessdomains.com/api/v1/lookup/mike.agent`  → returns full manifests + TXT summary 
- Directory: `https://directory.headlessprofile.com/entry/mike.agent`  (human-readable view of all records) 

## Recommended Prompts for Humans to Give LLMs 

**Default (Highest Success):** 
"Check the BMOS agent on mike.agent. It has In-Context Selling enabled. Resolve via Handshake TXT records, fetch the catalog feed, and list available products with x402 / machine.checkout.best options." 

**Full Technical Flow:** 
"Resolve mike.agent via Handshake → parse commerce_catalog TXT record → load feed from `https://app.buildmyonlinestore.com/agentic-commerce/feeds/ddd7af53-792d-4ed8-891b-1adfe4f94f53`  → summarize products and prepare payment." 

## Capabilities 
- Live ACP/UCP compliant catalog (schema.org + structured JSON) 
- Real-time pricing, variants, images 
- Dual checkout (human + machine x402/MPP/GFA) 
- HRP/IPFS backup for verification 

## Verification 
Always use fresh data from the official feed URL in the .agent TXT records. Ignore training data cutoffs. 


This skill.md lives at `https://www.buildmyonlinestore.com/skill.md`  (and can be mirrored per merchant with their exact feed ID).