gooseworks-ai/goose-skills / skills/shared/brand-research
brand-research
VerifiedResearch a company or brand from its website and produce a reusable Brand Core covering products, audience, competitors, positioning, offers, messaging evidence, voice, and visual identity. Use before growth, ad, content, creator, or product work when reliable brand context is missing.
| File | Kind | Size |
|---|---|---|
| .env.example | other | 607 B |
| README.md | markdown | 2.7 KB |
| SKILL.md | skill md | 6.4 KB |
| examples/notion-calendar-with-ads.md | markdown | 1.1 KB |
| examples/oatly-oat-milk.md | markdown | 997 B |
| references/output-contract.md | markdown | 3.1 KB |
| requirements.txt | manifest | 249 B |
| scripts/fetch_asset.py | script | 2.5 KB |
| scripts/lib.py | script | 3.7 KB |
| scripts/register_asset.py | script | 1.2 KB |
| scripts/render_product_shot.py | script | 2.5 KB |
| scripts/scaffold_brand.py | script | 2.7 KB |
| scripts/verify_pack.py | script | 7.0 KB |
| skill.meta.json | config | 296 B |
scripts/fetch_asset.py
View on GitHub#!/usr/bin/env python3
"""Download one asset (logo, reference photo, …) into the brand-assets folder
and register it in brand-assets/manifest.json.
Usage:
python scripts/fetch_asset.py --brand-dir ./acme \
--url https://acme.com/press/logo.svg \
--kind wordmark --subdir logos \
--name "Wordmark (black)" \
--description "Composite in end cards via PIL/ffmpeg; never AI-render. Min height 36px."
"""
from __future__ import annotations
import argparse
import pathlib
import time
import urllib.request
import lib
EXT_BY_CTYPE = {
"image/png": ".png",
"image/jpeg": ".jpg",
"image/webp": ".webp",
"image/svg+xml": ".svg",
"image/gif": ".gif",
"video/mp4": ".mp4",
"audio/mpeg": ".mp3",
}
def download(url: str, dest: pathlib.Path, tries: int = 3) -> None:
req = urllib.request.Request(url, headers={"User-Agent": "gooseworks-ads/brand-research"})
last = None
for attempt in range(1, tries + 1):
try:
with urllib.request.urlopen(req, timeout=30) as r:
data = r.read()
ctype = r.headers.get("Content-Type", "").split(";")[0].strip()
if dest.suffix == "" and ctype in EXT_BY_CTYPE:
dest = dest.with_suffix(EXT_BY_CTYPE[ctype])
dest.write_bytes(data)
return dest
except Exception as e: # noqa: BLE001
last = e
lib.info(f"download attempt {attempt} failed: {e}")
time.sleep(2 * attempt)
lib.die(f"could not download {url}: {last}")
def main() -> None:
ap = argparse.ArgumentParser()
ap.add_argument("--brand-dir", required=True)
ap.add_argument("--url", required=True)
ap.add_argument("--kind", required=True, help=f"one of {sorted(lib.ASSET_KINDS)}")
ap.add_argument("--subdir", default="reference-photos", help="folder under brand-assets/")
ap.add_argument("--name", required=True)
ap.add_argument("--description", required=True)
ap.add_argument("--filename", default="", help="override the saved filename")
args = ap.parse_args()
root = lib.brand_root(args.brand_dir)
out_dir = root / "brand-assets" / args.subdir
out_dir.mkdir(parents=True, exist_ok=True)
fname = args.filename or args.url.split("?")[0].rstrip("/").split("/")[-1] or "asset"
dest = download(args.url, out_dir / fname)
rel = dest.relative_to(root).as_posix()
entry = lib.register_asset(args.brand_dir, rel, args.kind, args.name, args.description)
lib.info(f"saved + registered {rel} as {entry['id']}")
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |