openseo-keyword-clustering SKILL.md skillA

openseo-keyword-clustering from moizibnyousaf/marketing-cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add moizibnyousaf/marketing-cli/openseo-keyword-clustering@git:20260831.6fa6c6f

Pins git:20260831.6fa6c6f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
moizibnyousaf/marketing-cli
Path
skills/openseo-keyword-clustering/SKILL.md
Versions recorded
3
Latest version
git:20260831.6fa6c6f, committed Aug 31, 2026
First version recorded
Jul 28, 2026
Size
5,085 bytes
Repository stars
34
License
MIT

Cluster keywords by search intent and map each cluster to an existing or proposed page, with cannibalization detection from Search Console. Use this skill when the user has a keyword list (saved set, brand/keyword-plan.md, GSC export, or seed topic) and needs page targets, content briefs, or a site map for SEO pages — especially before seo-content or seo-machine page generation. Triggers: "cluster keywords", "keyword mapping", "map keywords to pages", "keyword cannibalization…

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

# OpenSEO Keyword Clustering

Group keywords into page-level clusters and assign each to an existing URL, a new page proposal, or a do-not-target bucket. Output lands in `marketing/seo/clusters/*.md` (per-cluster briefs) and feeds `seo-content` / `seo-machine` with measured page targets.

## On Activation

1. **Readiness + binding**: `mktg seo status --json --fields readiness,catalog.endpointError,project`. No binding → `openseo-project-setup` first. `not_configured` → do lexical clustering with Exa context but label every cluster "SERP-unvalidated." For a ready state, verify live access with the free `whoami` MCP tool before paid calls.
2. **Keyword source**: prefer (a) `brand/keyword-plan.md` populated sections, (b) `list_saved_keywords` with a tag, (c) GSC live data, (d) seed discovery via `research_keywords`. Under 10 usable terms → simple map, no clustering ceremony.

## OpenSEO MCP Tools

- `get_search_console_performance` with `dimensions: ["query","page"]`: the cannibalization truth source — one query splitting impressions across multiple URLs means existing cannibalization, not theoretical risk.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add moizibnyousaf/marketing-cli/openseo-keyword-clustering@sha256:1001647e2b5f368c

The line at the top of this page pins the label git:20260831.6fa6c6f, 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_o2f5my44sj2cqzky.svg)](https://markdownregistry.com/a/art_o2f5my44sj2cqzky)

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

Versions

The registry has recorded 3 versions of this file, between Jul 28, 2026 and Aug 31, 2026, about one every 17 days.

versioncommittedcommitsizeaudit
git:20260831.6fa6c6f latest2026-08-31 6fa6c6f 5,085 BA view · diff
git:20260816.3161ba82026-08-16 3161ba8 5,017 BA view · diff
git:20260728.100d3f12026-07-28 100d3f1 4,767 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 (5085 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

moizibnyousaf/marketing-cli · 34 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_o2f5my44sj2cqzky
GET https://markdownregistry.com/api/v1/resolve?ref=moizibnyousaf/marketing-cli/openseo-keyword-clustering
GET https://markdownregistry.com/api/v1/blob/1001647e2b5f368c751ca00236e2a94755be32f301e8a6e8315711c5e749a889

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 moizibnyousaf/marketing-cli

AGENTS.md AGENTS.md file
moizibnyousaf/marketing-cli · AGENTS.md
git:20260831.829d37a · audit B · 34 stars
CLAUDE.md CLAUDE.md file
moizibnyousaf/marketing-cli · CLAUDE.md
git:20260831.829d37a · audit A · 34 stars
agent-email-inbox SKILL.md skill
moizibnyousaf/marketing-cli · skills/agent-email-inbox/SKILL.md · Use when setting up a secure email inbox for any AI agent — configuring inbound email via Resend, webhooks, tunneling…
git:20260503.12df1f3 · audit F · 34 stars
ai-seo SKILL.md skill
moizibnyousaf/marketing-cli · skills/ai-seo/SKILL.md · Builds, measures, and improves an Answer Engine Optimization program across ChatGPT, Perplexity, Claude, Gemini, Google…
git:20260831.6fa6c6f · audit A · 34 stars
app-store-screenshots SKILL.md skill
moizibnyousaf/marketing-cli · skills/app-store-screenshots/SKILL.md · Generate Apple App Store screenshot pages as a Next.js app with html-to-image export at required resolutions…
git:20260503.12df1f3 · audit A · 34 stars
audience-research SKILL.md skill
moizibnyousaf/marketing-cli · skills/audience-research/SKILL.md · Build detailed buyer personas and audience profiles from research. Use this skill whenever the user mentions audience…
git:20260718.0093b9f · audit A · 34 stars
axi SKILL.md skill
moizibnyousaf/marketing-cli · skills/axi/SKILL.md · Agent eXperience Interface (AXI) router — the main entry point for agent-ergonomic CLIs. Use whenever the agent needs…
git:20260816.3161ba8 · audit A · 34 stars
brainstorm SKILL.md skill
moizibnyousaf/marketing-cli · skills/brainstorm/SKILL.md · Structured marketing brainstorming when direction is unclear. Use when the agent doesn't know which skill to run, the…
git:20260503.12df1f3 · audit A · 34 stars
brand-kit-playground SKILL.md skill
moizibnyousaf/marketing-cli · skills/brand-kit-playground/SKILL.md · Generate an interactive HTML brand playground that shows your brand rendered live — palette, typography, logo, voice —…
git:20260503.12df1f3 · audit B · 34 stars
brand-voice SKILL.md skill
moizibnyousaf/marketing-cli · skills/brand-voice/SKILL.md · Define or extract a consistent brand voice that other skills can use. Three modes: Extract (analyze existing content)…
git:20260816.3161ba8 · audit A · 34 stars
build-with-exa SKILL.md skill
moizibnyousaf/marketing-cli · skills/build-with-exa/SKILL.md · Build applications and agents with Exa's API Platform: search, contents, answer, context, Agent API, monitors, websets…
v0.1.0 · audit A · 34 stars
churn-prevention SKILL.md skill
moizibnyousaf/marketing-cli · skills/churn-prevention/SKILL.md · Designs cancel flow UX, dunning email sequences, win-back campaigns, and retention triggers. Covers the full churn…
git:20260503.12df1f3 · audit A · 34 stars

Every file in moizibnyousaf/marketing-cli

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