{"skill":{"slug":"seo-owls-claw","displayName":"SEO 🦉OwlsClaw - Research * Plan * Write","summary":"Generates persona-driven, SEO-optimized content and plans with multi-client brand profiles, locale-aware templates, and deploy-ready HTML including schema ma...","tags":{"latest":"0.8.0"},"stats":{"comments":0,"downloads":71,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1776247359606,"updatedAt":1776248211666},"latestVersion":{"version":"0.8.0","createdAt":1776247359606,"changelog":"# SEOwlsClaw 🦉⚡\n### *Pronounced \"See-Owls-Claw\"*\n\n> Drop it into your AI agent. Get a full-stack SEO content system.\n\nSEOwlsClaw is a modular SEO skill for AI agents. One install turns your agent\ninto a structured SEO writer, content strategist, and brand-aware publishing\nengine — with zero generic AI filler.\n\n---\n\n## What It Does\n\nYou give it a niche. It builds you a ranked content plan.\nYou give it a topic. It writes a full brief before touching a word.\nYou give it a prompt. It returns deploy-ready HTML or clean CMS text.\n\nEvery output matches search intent, passes a built-in SEO audit,\nrespects your brand rules, and is ready to publish.\n\n---\n\n## ✨ What's Inside\n\n**🧠 Intelligent Search Intent Detection**\nAutomatically picks the right page format before writing a single word.\nInformational → Blogpost. Transactional → Productnew. No mismatches.\n\n**🗺️ SEO Cluster Planning** `/seoplan`\nBuild a complete content cluster for any niche. Nodes are tiered into\nPILLAR / QUICKWIN / FOUNDATION / STRATEGIC — with keyword data,\ndifficulty scores, persona assignments, an internal link matrix,\nand a numbered execution order. One command, full roadmap.\n\n**📋 Brief-First Workflow** `/seobrief`\nGenerate a structured content brief before writing — keyword cluster,\nH1–H4 outline, PAA questions, competitor gaps, internal link targets.\nPass it to `/write` with `--from-brief` and the content matches it exactly.\n\n**🏢 Multi-Client Brand Profiles** `/brand`\nLoad a client brand profile per session. Activates brand-specific CTAs,\ntone sliders, vocabulary rules, banned phrases, and a compliance check\nthat hard-blocks output if violations are found.\n\n**✍️ Persona-Driven Writing**\nSix built-in personas: E-Commerce Manager, Researcher, Creative Writer,\nBlogger, Vintage Expert, Travel Photographer. Each has its own heading\nformula, vocabulary set, E-E-A-T signals, and Zone A/B content rules.\n\n**🌐 Locale-Aware Output**\nMultilingual support via locale files. Language, currency, schema fields,\ndate formats, and CTAs all adapt automatically with `--lang`.\n\n**✅ Built-In SEO Audit Pipeline**\nEvery output runs through: title length, meta description, H1–H6\nstructure, Schema.org markup (Article, Product, FAQ, BreadcrumbList),\nZone A AI-overview compliance, persona compliance, and brand compliance.\n\n---\n\n## 🛠️ Quick Start\n\n```bash\n# Plan a full content cluster\n/seoplan \"Best hiking gear Germany\" --lang de --priority quickwins\n\n# Brief a single page from the plan\n/seobrief Blogpost \"Hiking boots guide\" --plan hiking-gear-de.qw-01 --lang en\n\n# Write deploy-ready HTML from the brief\n/brand my-client\n/persona blogger\n/writehtml Blogpost \"Hiking boots guide\" --from-brief hiking-boots-guide-de --lang en\n```\n\nOr skip straight to content:\n\n```bash\n/persona ecommerce-manager\n/write Productnew \"TrailMaster X5 Hiking Boot, waterproof, sizes 38–47\" \\\n  --primary-kw \"waterproof hiking boots buy\" --lang en\n```\n\n---\n\n## 📦 What's Included\n- Core skill + full brain architecture (13-step processing pipeline)\n- 6 writing personas with heading formulas and E-E-A-T rules\n- HTML templates: Blogpost, Productnew, Productused, Landingpage, FAQ, Social\n- SEO audit checklists per page type + schema markup rules\n- Brand profile system (`BRANDS/`) with compliance enforcement\n- SEO brief system (`SEO_BRIEFS/`) with `--from-brief` integration\n- SEO cluster planning system (`SEO_PLANS/`) with lazy-loaded workflow logic\n- Locale files for multilingual output\n\n---\n\n*SEOwlsClaw — because good SEO content should be structured, not scattered.*\n\n───\n\n✅ Built-in SEO Pipeline\nEvery output runs through:\n\n🔍 Search intent detection — wrong format = wrong ranking signal, caught before writing\n📋 E-E-A-T checks — expertise, experience, authority, and trust signals verified\n🏷️ Schema.org validation — Product, Article, FAQPage, BreadcrumbList, Event/Offer\n📏 On-page SEO — title length, meta description, H1 uniqueness, heading structure\n🚫 Trap detection — keyword stuffing, thin content, missing schema, broken links\n🌐 Locale compliance — correct date format, price format, formality register, slugs\n\n───\n\n🗂️ Page Types\n| Type        | Best For                  | Words      |\n| ----------- | ------------------------- | ---------- |\n| Blogpost    | Guides, articles, how-tos | 1,500w+    |\n| Landingpage | Sales, campaigns, promos  | 900–1,200w |\n| Productnew  | New product listings      | 400–600w   |\n| Productused | Used / refurbished items  | 500–700w   |\n| FAQ         | FAQ pages, PAA targeting  | 800–1,200w |\n| Socialphoto | Image captions, alt text  | 100–200w   |\n| Socialvideo | YouTube / TikTok metadata | 150–300w   |\n\n___\n\n🎭 Personas\n| ID                  | Vibe                                             |\n| ------------------- | ------------------------------------------------ |\n| blogger             | Friendly, educational, story-driven (default)    |\n| ecommerce-manager   | Persuasive, urgent, conversion-focused           |\n| creative-writer     | Narrative, emotional, brand-driven               |\n| researcher          | Neutral, fact-based, structured                  |\n| vintage-expert      | Authoritative, precise, collector-focused        |\n| travel-photographer | Scenario-driven, gear-focused, location-specific |\n\n___\n\n🌍 Multilingual — 4 Languages Ready\nUses a Base + Delta architecture. base.md holds all English defaults. Language files only define what's different — keeping files short and easy to maintain.\nLOCALE/\n├── base.md   ← English defaults for everything\n├── de.md     ← German (Sie-form, DD.MM.YYYY, 1.090,00 €, umlaut slugs)\n├── fr.md     ← French (vous-form, « guillemets », thin-space thousands)\n├── es.md     ← Spanish (tú-form, ¿¡ punctuation, MX + AR variants)\n└── pt.md     ← Portuguese (você-form, PT + BR variant)\n\n___\n\n## ⚡ Commands\n\n### Strategy\n| Command | What it does |\n|---------|-------------|\n| `/seoplan \"niche\"` | Build a full content cluster — tiered nodes, keyword data, link matrix, execution order |\n| `/seobrief <type> \"topic\"` | Generate a structured brief before writing — KWs, outline, PAA, competitor gaps |\n\n### Brand\n| Command | What it does |\n|---------|-------------|\n| `/brand <id>` | Load a client brand profile — activates CTAs, tone, vocab rules, and compliance checks |\n| `/brands` | List all brand profiles |\n| `/brands --show <id>` | Show full details of one brand profile |\n\n### Content\n| Command | What it does |\n|---------|-------------|\n| `/persona <id>` | Set writing persona (stays active for the session) |\n| `/personas` | List all personas with one-line descriptions |\n| `/personas --show <id>` | Show full persona details |\n| `/write <type> \"prompt\"` | Plain text output — editor/CMS-ready |\n| `/writehtml <type> \"prompt\"` | Pure HTML output — deploy-ready |\n\n### Research & Audit\n| Command | What it does |\n|---------|-------------|\n| `/research \"topic\"` | Keyword cluster + SERP analysis |\n| `/checks <url>` | SEO audit on a live URL |\n| `/checks <type>` | SEO audit on a page type (preview mode) |\n\n---\n\n### 🚩 Flags\n\n| Flag | Works with | Purpose |\n|------|-----------|---------|\n| `--primary-kw \"kw\"` | `/write` `/writehtml` | Main target keyword |\n| `--secondary-kw \"kw\"` | `/write` `/writehtml` | Secondary keyword cluster |\n| `--lang de\\|en\\|fr\\|es` | all commands | Output language + locale |\n| `--tone casual\\|formal\\|…` | `/write` `/writehtml` | Override persona tone |\n| `--depth light\\|standard\\|deep` | `/write` `/writehtml` `/seobrief` | Content depth level |\n| `--from-brief <id>` | `/write` `/writehtml` | Load a saved brief — aligns output to its outline and KWs |\n| `--plan <plan-id>.<node-id>` | `/write` `/writehtml` `/seobrief` | Load a plan node — pulls KWs, page type, and link targets |\n| `--brand <id>` | all commands | Load brand profile inline (alternative to `/brand`) |\n| `--mode cluster\\|site` | `/seoplan` | Single cluster or full site architecture |\n| `--priority balanced\\|quickwins\\|strategic` | `/seoplan` | What tiers to focus on |\n| `--pages <n>` | `/seoplan` | Override node count |\n\n___\n\n📁 Structure\n\nseowlowsclaw/\n│\n├── SKILL.md                    ← This file — core instructions + command reference\n├── BRAIN_ARCHITECTURE.md       ← Complete processing logic (all 9 brain steps)\n├── COMMANDS.md                 ← Full command reference with all flags\n├── PAGE_STRUCTURES.md          ← Master index + links to all page templates\n├── SEO_PATH.md                 ← Full SEO workflow: research → analysis → writing → checks\n│\n├── PERSONAS/                   ← One file per persona\n│   ├── _index.md               ← Load first — lists all persona IDs and file paths\n│   ├── ecommerce-manager.md\n│   ├── creative-writer.md\n│   ├── blogger.md              ← Default persona when none specified\n│   ├── researcher.md\n│   ├── vintage-expert.md\n│   └── travel-photographer.md\n│\n├── BRANDS/                     ← One file per client brand profile\n│   ├── _index.md               ← Load first — lists all brand IDs and file paths\n│   └──  brand-template.md       ← Copy this to create a new brand profile\n│\n├── LOCALE/                     ← Language override files (Base + Delta architecture)\n│   ├── base.md                 ← English defaults for all locale keys — always loaded\n│   ├── de.md                   ← German overrides (--lang de)\n│   ├── fr.md                   ← French overrides (--lang fr)\n│   ├── es.md                   ← Spanish overrides (--lang es)\n│   └── pt.md                   ← Portuguese overrides (--lang pt)\n│\n├── SEO_BRIEFS/                 ← Generated content briefs (one per topic/page)\n│   └── _index.md               ← Registry: brief-id | topic | type | date | status\n│\n├── SEO_PLANS/                  ← One plan file per niche/site campaign\n│   ├── _index.md               ← Registry: plan-id | niche | mode | lang | date\n│   ├── plan-template.md        ← Format reference + example plan\n│   └── plan_workflow.md        ← Full /seoplan pipeline logic (Steps A–G) — loaded only on /seoplan\n│\n├── SEO_CHECKS/                 ← SEO rules, intent detection, schema, quality checks\n│   ├── search_intent.md        ← Step 0 rules — intent detection + format selection\n│   ├── do-and-don-lists.md     ← Page-type specific dos and don'ts\n│   ├── schema-markup.md        ← Schema.org rules + {SCHEMA_*} variable definitions\n│   ├── seo-checks-reference.md ← Full SEO check reference\n│   └── seo-output-quality-checklist.md ← Pre-output quality gates\n│\n├── TEMPLATES/                  ← HTML output templates (used by /writehtml only)\n│   ├── blog_post_template.md\n│   ├── landing_page_template.md\n│   ├── product_new_template.md\n│   ├── product_used_template.md\n│   └── faq_page_template.md\n│\n├── TEMPLATES_SOCIAL/           ← Social media output templates\n│   ├── photo_post_template.md\n│   └── video_post_template.md\n│\n├── OUTPUT_EXAMPLES/            ← Reference output examples for agent guidance\n│   ├── blog_post_example.md    ← Reference output examples for agent guidance (under development)\n│   ├── landing_page_example.md ← Reference output examples for agent guidance (under development)\n│   ├── product_new_example.md  ← Reference output examples for agent guidance (under development)\n│   └── product_used_example.md ← Reference output examples for agent guidance (under development)\n\n\n___\n\n  \n🎯 Perfect for\n\n* SEO projects & organic content creation\n* E-Commerce product pages (new & refurbished)\n* Sales campaigns & newsletter launches\n* Personal branding & storytelling content\n\n───\n\nVersion: v0.8 · Status: Active development · Maintainer: Chris\nSEOwlsClaw — Because good SEO content shouldn't need 10 different tools. 🦉\n\n───\nSEOwlsClaw v0.8 — Changelog\n\nSKILL.md\nUpdated from v0.6 → v0.8. Extended description to reflect full-stack agency capabilities.\nAdded 12 new trigger phrases for /brand, /seobrief, and /seoplan. Added 4 new rows to the Core Commands table. Replaced the Workflow Steps block with the complete 13-step version covering Steps 2d, 2e, 6.6 and skip rules for strategy commands. Added 2 new workflow examples (brief-first flow and full 3-phase agency flow). Extended the file tree with BRANDS/, SEO_BRIEFS/, and SEO_PLANS/ folder entries.\n\nBRAIN_ARCHITECTURE.md\nApply patches to v0.8\n\nAdded brand_id, brief_id, and --from-brief / --plan flag parsing to Step 1.\nv0.8 FINAL patch — Added Step 2d (brand profile load: reads BRANDS/<id>.md, merges brand variables and CTAs into the variable dict, stores compliance object for Step 6.6, skipped when no brand is active). Added Step 2e (SEO plan pointer: if /seoplan is active, load SEO_PLANS/plan_workflow.md and run Steps A–G, then stop — Steps 3–7 do not run). Added Step 6.6 (brand and legal compliance check: banned phrase scan, urgency limit enforcement, required disclosure validation — HARD FAIL blocks output). Updated the Workflow Summary Quick Reference to reflect all 13 steps.\n\nCOMMANDS.md\nApply patches v0.8\n\nFull /brand, /brands, and /seobrief command documentation including all flags, examples, and the --from-brief integration with /write.\nv0.8 patch — Full /seoplan command documentation including --mode, --priority, --depth, --pages flags, node tier reference table with difficulty thresholds and timeline estimates, all three priority modes explained, and the complete 3-phase workflow example. Added --plan <plan-id>.<node-id> flag documentation for /seobrief and /write.\n\nBRANDS/ (new folder)\n_index.md — Registry of all client brand profiles. One row per brand. Referenced by /brand and /brands commands at runtime.\nbrand-template.md — Blank template for any new client. Fields include: tone sliders, CTAs per language, vocabulary rules (allowed/banned phrases, brand terms), trust blocks, compliance settings (urgency limit, artificial scarcity flag, required disclosures), and condition grade vocabulary.\n\nSEO_BRIEFS/ (new folder)\n_index.md — Registry of all generated content briefs. Auto-populated when /seobrief runs. Tracks brief-id, topic, page type, language, brand, date, and status (draft / approved / in-production / published).\n\nSEO_PLANS/ (new folder)\n_index.md — Registry of all generated SEO cluster and site plans. Auto-populated when /seoplan runs.\n\nplan-template.md — Defines the exact machine-parseable format for all plan files. Includes a fully filled-in example (11-node cluster, vintage analog cameras, DE market) covering all four tiers with keyword data, persona assignments, internal link matrix, and execution order.\n\nplan_workflow.md — Full /seoplan processing pipeline (Steps A–G). Lazy-loaded only when /seoplan fires — never loaded during content generation commands. Contains: niche research logic, quick win threshold calculation, cluster architecture design rules for --mode cluster and --mode site, node tiering criteria for all four tiers (PILLAR / QUICKWIN / FOUNDATION / STRATEGIC), persona assignment per tier, internal link matrix rules (no orphan nodes), execution order logic for all three --priority modes, plan quality check gate, and output + save instructions.\n\n- Major documentation expansion: SKILL.md updated with full capability declaration, usage triggers, file map, and detailed command reference.\n- Precise workflow instructions provided for persona-driven writing, multi-client brand handling, and locale-aware output.\n- Core commands, file loading rules, and output formats now clearly described for user and agent guidance.\n- Security and execution gating clarified, including explicit requirements for file saves and SERP lookups.\n- All templates, personas, brand files, and audit tools now mapped with load conditions for efficient workflow navigation.","license":"MIT-0"},"metadata":null,"owner":{"handle":"larya-dot-eu","userId":"s17em8xjnda6ax53afsgj0f6yn84e4np","displayName":"larya-dot-eu","image":"https://avatars.githubusercontent.com/u/269713401?v=4"},"moderation":null}