search-term-miner SKILL.md skillA

search-term-miner from aaron-he-zhu/aaron-marketing-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add aaron-he-zhu/aaron-marketing-skills/search-term-miner@v20.2.0

Pins v20.2.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
aaron-he-zhu/aaron-marketing-skills
Path
ad/research/search-term-miner/SKILL.md
Versions recorded
6
Latest version
v20.2.0, committed Oct 29, 2026
First version recorded
Jul 24, 2026
Size
8,665 bytes
Repository stars
3,102
License
Apache-2.0

Use when the user asks to "mine my search terms", "find new keywords from converting queries", "build a negative-keyword list", or "cut wasted paid spend"; harvests converting queries into new keywords/ad-groups, builds a standing negative-keyword list and an n-gram waste report from the search-terms export, and delivers a maintenance diff (add / negate / move). Not for account structure — use campaign-architect; not for budget split — use budget-optimizer; not for computing the final RQS —…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Search Term Miner

Turns a search-terms report into two standing outputs: new keywords/ad-groups harvested from converting queries, and a negative-keyword + n-gram waste list built from queries that spent without converting. It is the recurring mining loop that `campaign-architect` used to carry as a mode — that skill now owns account structure only, and this skill owns the search-term harvest and negative hygiene. It scores the ROAS **S (Spend-efficiency)** lever it works on and hands off; it does not compute the final RQS.

## Quick Start

```
Mine my search terms. Here is my exported search-terms report: [paste/path]. Goal is [DR/prospecting].
```

```
Build a negative-keyword list and an n-gram waste report from this search-terms export: [path].
```

```
Which converting queries should become new keywords or ad groups? Here is the search-terms + conversions export.
```

## Skill Contract
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add aaron-he-zhu/aaron-marketing-skills/search-term-miner@sha256:395d670374c69654

The line at the top of this page pins the label v20.2.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2z4en5w3hw27lzov.svg)](https://markdownregistry.com/a/art_2z4en5w3hw27lzov)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Jul 24, 2026 and Oct 29, 2026, about one every 19 days.

versioncommittedcommitsizeaudit
v20.2.0 latest2026-10-29 0d0dabf 8,665 BA view · diff
v20.1.02026-09-01 0c914b1 8,665 BA view · diff
v20.0.02026-08-20 879002a 8,665 BA view · diff
v19.2.02026-08-10 d09dd90 8,665 BA view · diff
v19.1.02026-08-01 f744424 8,665 BA view · diff
v19.0.02026-07-24 407137c 8,665 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8665 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

aaron-he-zhu/aaron-marketing-skills · 3,102 stars · license Apache-2.0 · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2z4en5w3hw27lzov
GET https://markdownregistry.com/api/v1/resolve?ref=aaron-he-zhu/aaron-marketing-skills/search-term-miner
GET https://markdownregistry.com/api/v1/blob/395d670374c69654b85c44ff3a8172c1a2da5cad93cbd8f0f6810b6a0cabe95b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from aaron-he-zhu/aaron-marketing-skills

AGENTS.md AGENTS.md file
aaron-he-zhu/aaron-marketing-skills · AGENTS.md
git:20261029.0d0dabf · audit A · 3,102 stars
CLAUDE.md CLAUDE.md file
aaron-he-zhu/aaron-marketing-skills · CLAUDE.md
git:20261029.0d0dabf · audit A · 3,102 stars
ad-account-auditor SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/activate/ad-account-auditor/SKILL.md · Use when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before…
v20.2.0 · audit A · 3,102 stars
conversion-signal-qa SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/activate/conversion-signal-qa/SKILL.md · Use when the user asks to "QA my conversion tracking before launch", "check my UTMs / pixel / event firing", "set up a…
v20.2.0 · audit A · 3,102 stars
conversion-value-mapper SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/activate/conversion-value-mapper/SKILL.md · Use when the user asks to "set up conversion values so tROAS optimizes profit not orders", "map margin onto my purchase…
v20.2.0 · audit A · 3,102 stars
placement-exclusion-manager SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/activate/placement-exclusion-manager/SKILL.md · Use when the user asks to "build my brand-safety exclusion lists", "set placement / topic / content exclusions before…
v20.2.0 · audit A · 3,102 stars
ad-creative-builder SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/orchestrate/ad-creative-builder/SKILL.md · Use when the user asks to "write ad copy", "generate RSA headlines", or "build ad creative at volume"; produces ad…
v20.2.0 · audit A · 3,102 stars
ad-test-designer SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/orchestrate/ad-test-designer/SKILL.md · Use when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is…
v20.2.0 · audit A · 3,102 stars
bid-strategy-planner SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/orchestrate/bid-strategy-planner/SKILL.md · Use when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"…
v20.2.0 · audit A · 3,102 stars
landing-experience-checker SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/orchestrate/landing-experience-checker/SKILL.md · Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page…
v20.2.0 · audit A · 3,102 stars
audience-segment-builder SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/research/audience-segment-builder/SKILL.md · Use when the user asks to "build audience segments from my customer list", "make value-based / lookalike seed lists"…
v20.2.0 · audit A · 3,102 stars
campaign-architect SKILL.md skill
aaron-he-zhu/aaron-marketing-skills · ad/research/campaign-architect/SKILL.md · Use when the user asks to "plan my paid account structure", "pick Search vs PMax", "lay out ad groups / asset groups"…
v20.2.0 · audit A · 3,102 stars

Every file in aaron-he-zhu/aaron-marketing-skills

Browse by kind, by grade A, or by owner.