Zach Search Term Report Analyzer

What it does

When your agent uses it

• Tasks that involve E-commerce operations
• Tasks that involve CSV and tabular files

Example prompts

• “/zach-search-term-report-analyzer”

Requirements

• Python 3
• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1禁止使用 uncertain_term，必须给出 category 和 relevance。
2. 2所有待分类词根必须覆盖，缺一个 Stage C 都会失败。
3. 3needs_listing_check 只用于少数确实依赖页面能力才能判断的词根。
4. 4只有成员词明显偏离词根语义时才写 term_overrides。
5. 5否词判断必须同时考虑相关性、样本量和 Listing 承接，不因一次点击机械否定。

What it can do on your machine

Read from SKILL.md and the folder at commit 5c790ea. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash
  • Glob
  • Grep

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 4 files in scripts/ (Python, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Zach Search Term Report Analyzer loads about 1.1k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 236 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~71

When it runs · the whole SKILL.md, loaded when a task matches

~1.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Write, Edit, Bash, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from zach22-1999/amazon-skills at commit 5c790ea, republished under its MIT licence (© zach22-1999). 236 words, ~1,147 tokens.

name

zach-search-term-report-analyzer

description

分析 Amazon Ads SP / SB / SD 搜索词报告。确定性脚本负责清洗、时间窗聚合、词根聚类和决策计算，AI 助手或人工负责词根级语义分类；通过词根继承减少长尾词的待判定比例，输出 Markdown、CSV、HTML 和 JSON 六类结果。 使用时机：判断搜索词是否应该否定、控成本、继续测试或放量，分析 7/14/30 天 CVR 与 ACOS 变化，或者提炼可反馈给 Listing 的属性词和场景词。 触发词：/zach-search-term-report-analyzer

allowed-tools

Read, Write, Edit, Bash, Glob, Grep

triggers

/zach-search-term-report-analyzer

user-invocable

true

risk-level

medium

搜索词报告
  → Stage A：清洗、7/14/30 天聚合、词根聚类、硬标签
  → Stage B：AI 助手或人工完成词根语义分类
  → Stage C：严格校验、词根决策继承、六类结果渲染

python3 skills/zach-search-term-report-analyzer/scripts/prepare_search_term_analysis.py \
  <input_file> \
  --asin B0XXXXXXXX \
  --brand ExampleBrand \
  --site US \
  --target-acos 0.20 \
  --windows 7,14,30 \
  --listing-context-file <optional-listing-context.md> \
  --output-dir outputs/search-term-report-analyzer/ExampleBrand/intermediate/

{
  "asin": "B0XXXXXXXX",
  "classified_by": "ai_assistant",
  "listing_context_source": "workbook.meta.listing_context",
  "roots": {
    "portable karaoke": {
      "category": "core_category_term",
      "relevance": "high",
      "note": "与目标商品的核心用途直接一致",
      "needs_listing_check": false
    }
  },
  "term_overrides": {}
}

python3 skills/zach-search-term-report-analyzer/scripts/finalize_search_term_report.py \
  outputs/search-term-report-analyzer/ExampleBrand/intermediate/workbook.json \
  --classifications outputs/search-term-report-analyzer/ExampleBrand/intermediate/root_classifications.json \
  --output-dir outputs/search-term-report-analyzer/ExampleBrand/

© zach22-1999, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 32 other files (scripts, references, assets) in skills/zach-search-term-report-analyzer of zach22-1999/amazon-skills.

• SKILL.md
• README.md
• assets/console_template.html
• assets/report_template.html
• examples/listing-context-sample.md
• examples/root-classifications-sample.json
• examples/search-term-report-sample.csv
• references/architecture.md
• references/decision_rules.md
• references/field_mapping.md
• references/output_template.md
• references/term_classification.md
• requirements.txt
• scripts/analyze_search_term_decisions.py
• scripts/browser_utils.py
• scripts/clean_search_term_report.py
• scripts/fetch_listing_context.py
• … and 16 more

Open the folder on GitHubat commit 5c790ea