brand-scout
starsforks
How to install brand-scout?
themattberman/brand-shoot-kit/brand-scout
$npx -y skills add TheMattBerman/brand-shoot-kit --skill brand-scoutExtract brand/product evidence from an ecommerce product URL before any Brand Shoot Kit planning or generation. Use for PDP scouting, source evidence capture, product image URL collection, degraded-mode notes, and scout.json creation. Do not use for ad spying or competitor ad res
SKILL.md
| 1 | # Brand Scout |
| 2 | |
| 3 | Capture evidence before strategy. Your job is not to be creative yet; it is to prevent hallucinated creative direction. |
| 4 | |
| 5 | ## Output Contract |
| 6 | |
| 7 | Produce `scout.json` with: |
| 8 | - `url`, `title`, `meta_description`, `og_title`, `og_description` |
| 9 | - `h1[]`, `image_urls[]` |
| 10 | - visible product/category/tone clues |
| 11 | - structured extraction fields: |
| 12 | `product_name`, `brand_name`, `product_type`, `product_category`, `price`, |
| 13 | `variants`, `claims_benefits`, `ingredients_materials_specs`, |
| 14 | `visible_packaging_text_candidates`, `image_evidence`, `field_confidence`, |
| 15 | `extraction_warnings` |
| 16 | - `degraded_mode` and `note` |
| 17 | - `scrape_provenance` (object) recording which adapter ran: |
| 18 | `{scraper, scraper_version, scraped_at, request_url, fixture_used, forced_by, firecrawl_meta?}`. |
| 19 | |
| 20 | Executable module owner path: |
| 21 | - `scripts/modules/brand_scout.py --url <product-url> --packet <packet-dir>` -> `scout.json` |
| 22 | - `scripts/scout-structured.py --in <scout.json> --out <scout.json>` for structured enrichment only. |
| 23 | |
| 24 | Scraper selection on the module: |
| 25 | - `--scraper {auto,curl,firecrawl}` (default `auto`). |
| 26 | - `auto` follows env precedence: `BSK_FORCE_SCRAPER` (used by `./evals/run.py`) → `FIRECRAWL_API_KEY` → curl default. |
| 27 | - Firecrawl failures exit code 2 with a one-line `--scraper curl` recovery hint. |
| 28 | |
| 29 | ## Rules |
| 30 | |
| 31 | - Evidence first, inference second. |
| 32 | - Mark confidence. Do not launder guesses into facts. |
| 33 | - If fetch fails, ask for PDP copy plus 3-5 product image URLs/uploads. |
| 34 | - Never scrape gated/private pages. |
| 35 | - Never drift into ad intelligence. |
| 36 | |
| 37 | ## Quality Bar |
| 38 | |
| 39 | A downstream agent should be able to cite where each product, tone, visual, and preservation clue came from. |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
