Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-product-ai-visibility

ecommerce.product-ai-visibility

Verified

Product AI Visibility & Ranking — evaluate how AI search engines (ChatGPT, Claude, Gemini, DeepSeek) recommend your product when shoppers ask buying questions. Triggers: AI visibility, product AI ranking, AI recommend, AI search, does AI mention my product.

FileKindSize
.nexscope-manifest.jsonconfig230 B
SKILL.mdskill md14.3 KB
assets/config.jsonconfig388 B
assets/prompts/evaluator.mdmarkdown9.1 KB
config.jsonconfig392 B
profiles/_template/product.mdmarkdown878 B
profiles/_template/queries.csvother1.5 KB
profiles/_template/query_rules.mdmarkdown1.2 KB
profiles/airscape-planetary-design-kilo-coffee-st/product.mdmarkdown1.9 KB
profiles/airscape-planetary-design-kilo-coffee-st/queries.csvother3.2 KB
profiles/airscape-planetary-design-kilo-coffee-st/query_rules.mdmarkdown525 B
profiles/aisi-hair-ombre-blonde-wig-glueless-curl/product.mdmarkdown1.2 KB
profiles/aisi-hair-ombre-blonde-wig-glueless-curl/queries.csvother2.6 KB
profiles/aisi-hair-ombre-blonde-wig-glueless-curl/query_rules.mdmarkdown428 B
profiles/apple-airpods-pro-3/product.mdmarkdown1.1 KB
profiles/apple-airpods-pro-3/queries.csvother2.2 KB
profiles/apple-airpods-pro-3/query_rules.mdmarkdown737 B
profiles/coffee-canister/product.mdmarkdown1.4 KB
profiles/coffee-canister/queries.csvother1.3 KB
profiles/coffee-canister/query_rules.mdmarkdown356 B
profiles/define-jacket-nulu/product.mdmarkdown1.1 KB
profiles/define-jacket-nulu/queries.csvother2.2 KB
profiles/define-jacket-nulu/query_rules.mdmarkdown736 B
profiles/iphone-17-pro/product.mdmarkdown1.3 KB
profiles/iphone-17-pro/queries.csvother2.2 KB
profiles/iphone-17-pro/query_rules.mdmarkdown731 B
profiles/macbook-air-m5/product.mdmarkdown1.0 KB
profiles/macbook-air-m5/queries.csvother2.1 KB
profiles/macbook-air-m5/query_rules.mdmarkdown732 B
profiles/rare-beauty/product.mdmarkdown1.5 KB
profiles/rare-beauty/queries.csvother1.6 KB
profiles/rare-beauty/query_rules.mdmarkdown1.1 KB
profiles/stanley-quencher-h2-0-flowstate-tumbler-/product.mdmarkdown1.4 KB
profiles/stanley-quencher-h2-0-flowstate-tumbler-/queries.csvother2.5 KB
profiles/stanley-quencher-h2-0-flowstate-tumbler-/query_rules.mdmarkdown763 B
scripts/__init__.pyscript0 B
scripts/_next_steps.pyscript10.1 KB
scripts/api_capture_runner.pyscript9.0 KB
scripts/api_client_base.pyscript8.2 KB
scripts/cli.pyscript10.0 KB
scripts/evaluator.pyscript6.9 KB
scripts/html_report.pyscript43.9 KB
scripts/loader.pyscript4.4 KB
scripts/normalizer.pyscript3.0 KB
scripts/preaggregate.pyscript7.0 KB
scripts/profile_builder.pyscript9.5 KB
scripts/send_report_email.pyscript4.4 KB
scripts/task_builder.pyscript2.7 KB
scripts/test_raw_api.pyscript2.6 KB
tmp-tr_4cc43ce22aaa/product_info.jsonconfig2.0 KB
tmp-tr_be2fd13607b6/product_info.jsonconfig2.1 KB

scripts/task_builder.py

View on GitHub
"""Evaluation task batch generator."""

import json
from pathlib import Path


def _read_file(path):
    if Path(path).exists():
        return Path(path).read_text(encoding="utf-8")
    return ""


def prepare_eval_tasks(config, run_dir, batch_size=None):
    """Generate eval batch task packages."""
    if batch_size is None:
        batch_size = config.eval_batch_size

    normalized_dir = run_dir / "normalized"
    eval_dir = run_dir / "eval"
    tasks_dir = run_dir / "tasks" / "eval"
    eval_dir.mkdir(parents=True, exist_ok=True)
    tasks_dir.mkdir(parents=True, exist_ok=True)

    skill_dir = Path(__file__).parent.parent
    evaluator_template = _read_file(skill_dir / "assets" / "prompts" / "evaluator.md")
    product_md = _read_file(config.base_dir / "profiles" / config.profile / "product.md")

    pending = []
    for nf in sorted(normalized_dir.glob("*.json")):
        eval_path = eval_dir / nf.name
        if not eval_path.exists():
            pending.append((nf, eval_path))

    tasks = []
    for batch_idx in range(0, len(pending), max(batch_size, 1)):
        batch = pending[batch_idx:batch_idx + batch_size]
        batch_name = f"batch-{batch_idx // batch_size + 1:03d}.md"
        task_path = tasks_dir / batch_name

        input_paths = [str(p[0].relative_to(run_dir)) for p in batch]
        output_paths = [str(p[1].relative_to(run_dir)) for p in batch]

        prompt_filled = evaluator_template.replace("{product_info}", product_md.strip())
        md_parts = [
            "# Eval Batch Task\n",
            "## Evaluator Prompt\n",
            prompt_filled,
            "\n---\n",
            "## File List\n",
            f"- Profile: `{config.profile}`",
            "- Input:",
            *[f"  - `{p}`" for p in input_paths],
            "- Output:",
            *[f"  - `{p}`" for p in output_paths],
            "\n## Execution Rules\n",
            "1. Generate independent eval JSON for each input file",
            "2. Strictly follow output schema",
            "3. product_recommendations must list all recommended products",
            "4. competitors_mentioned truncate to top 3",
        ]
        task_path.write_text("\n".join(md_parts), encoding="utf-8")

        tasks.append({
            "type": "eval_batch",
            "task_path": str(task_path.relative_to(run_dir)),
            "input_paths": input_paths,
            "output_paths": output_paths,
            "status": "pending",
        })

    manifest = {
        "schema_version": "task_manifest.v1",
        "run_id": run_dir.name,
        "profile": config.profile,
        "tasks": tasks,
    }
    manifest_path = run_dir / "tasks" / "manifest.json"
    manifest_path.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
    return manifest
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall