Skip to content

OXI-717/ai-native-toolkit / plugins/seo-hub/skills/seo-hub

seo-hub

Verified

Read-only SEO Hub CLI: registry and env-file checks, evidence routing.

FileKindSize
SKILL.mdskill md2.3 KB
agents/openai.yamlconfig231 B
---
name: seo-hub
description: "Read-only SEO Hub CLI: registry and env-file checks, evidence routing."
---

# seo-hub

Use this skill when the user asks about SEO Hub projects, registry setup, CLI
doctor output, or read-only routing for existing SEO/AI-search evidence. The
MVP is read-only.

Resolve the plugin root through the runtime-provided environment first, then make
sure the `seo-hub` CLI is installed before calling it — a fresh marketplace
install exposes this skill but does not install the nested Python package:

```bash
PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-<installed-plugin-root>}}"
uv tool install --force "$PLUGIN_ROOT/cli"
```

Install a regular package, not an editable link: plugin cache directories can
be removed during updates. Reinstall from the current plugin root after each
plugin update; `--force` also replaces earlier editable installations.

Follow this CLI order:

```bash
uv tool install --force "$PLUGIN_ROOT/cli"
seo-hub doctor --json --config <path>
seo-hub projects --json --config <path>
seo-hub status --project <id> --json --config <path>
seo-hub run --project <id> --mode full --json --config <path>
seo-hub report --project <id> --run <run_id> --json --config <path>
seo-hub opportunities --project <id> --run <run_id> --json --config <path>
seo-hub outcomes --project <id> --json --config <path>
seo-hub export --project <id> --run <run_id> --format observer-actions --json --config <path>
```

A successful `doctor` without a registry only confirms that the CLI starts.
Require `checks.config.status = "ready"` for project setup; provider connectivity
and evidence availability require a successful read-only import.

Do not pass `--live`. Do not trigger paid tools, deploy services, publish
reports, execute generated actions, or invent report data. Do not claim live
Topvisor, Yandex/Google cabinet, Metrica, or DataForSEO collection: v1 only
imports existing local evidence. `run` imports
existing evidence through read-only adapters and local files only. Keep mention,
citation, backlink, and branded query evidence as separate dimensions; treat
stale evidence, missing conversion data, and changed keyword baskets as quality
negatives, with changed baskets marked not comparable.

Owner-only Tunnel/Access setup and zero-cost native cross-check remain a
post-orchestrate checklist item. Worker sessions do not run them.
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall