AGENT SKILL

seo-optimizer

Audits and rewrites a page for organic search - title and meta lengths, heading hierarchy, intent match, internal links, schema markup, and Core Web Vitals - and returns a prioritized fix list. Use when someone asks "why isn't this page ranking", "audit my page for SEO", "rewrite my title and meta description", "does this need schema markup", or before publishing a page that must earn organic traffic. Do NOT use for grouping keywords into topical clusters across a site - use keyword-cluster-builder instead; do NOT use for planning a site-wide internal-link architecture - use internal-linking-mapper instead; do NOT use for restructuring content into AI-answer-ready blocks - use aeo-answer-blockifier instead; do NOT use for deep page-speed engineering - use web-performance instead.

License 许可
MIT
所属仓库
SkillMedev/skills
最近更新
2026-10-14
Stars
★ 25
Forks
3

01 前言 Front Matter

name
seo-optimizer
metadata
{ "title": "SEO Optimizer" }
description
Audits and rewrites a page for organic search - title and meta lengths, heading hierarchy, intent match, internal links, schema markup, and Core Web Vitals - and returns a prioritized fix list. Use when someone asks "why isn't this page ranking", "audit my page for SEO", "rewrite my title and meta description", "does this need schema markup", or before publishing a page that must earn organic traffic. Do NOT use for grouping keywords into topical clusters across a site - use keyword-cluster-builder instead; do NOT use for planning a site-wide internal-link architecture - use internal-linking-mapper instead; do NOT use for restructuring content into AI-answer-ready blocks - use aeo-answer-blockifier instead; do NOT use for deep page-speed engineering - use web-performance instead.

03 SKILL.md 正文

SEO Optimizer

Improve one page's organic visibility through content quality, technical signals, and structured data - without keyword stuffing. The costly mistake this prevents is optimizing the wrong layer: teams rewrite copy on a page whose title truncates in the SERP, whose intent mismatches the query, or that cannibalizes a sibling page, then conclude "SEO doesn't work." Audit in order; fix the highest layer that fails first.

Operating procedure

Intent comes before on-page elements, because a perfectly optimized page targeting the wrong intent cannot rank. On-page comes before schema and vitals, because rich results and speed amplify a page that already deserves to rank.

Step 1: Gather inputs

  1. The page URL or draft, and its one primary keyword. If the user has no primary keyword, that is the first deliverable - propose one and label it a guess.
  2. 2-4 semantic variants (default: derive from the primary).
  3. The intent behind the query: informational, navigational, or transactional. When unsure, check what currently ranks - the SERP is the ground truth for intent.
  4. Sibling pages targeting adjacent queries, to check cannibalization.

Step 2: Verify intent match

Match content type to intent: informational queries want guides and answers, transactional want product or category pages, navigational want the brand destination. If the page type contradicts the intent of its primary keyword, stop - no on-page fix rescues an intent mismatch; re-target or re-build. Each page must serve a distinct intent; consolidate cannibalizing pages rather than letting two half-strength pages split one query.

Step 3: Fix the head elements

  • Title tag: 50-60 characters - keep under 60 or the SERP truncates it; primary keyword near the front; unique per page.
  • Meta description: 140-155 characters, include a call to action. Not a ranking factor, but it is the ad copy that drives click-through.
  • URL slug: short, hyphenated, keyword-bearing, no stop words.

Bad: Home | Acme Inc | Solutions, Products, Services, About Us and More (74 chars, brand first, keyword nowhere). Good: Standing Desk Buying Guide: Height, Stability, Price | Acme (60 chars, keyword front-loaded).

Step 4: Fix the body structure

  1. Exactly one <h1> per page; logical <h2>/<h3> hierarchy that a reader could skim as an outline.
  2. Answer the query in the first 100 words - this is what earns featured-snippet eligibility.
  3. Keyword usage: target the primary plus 2-4 semantic variants; keep density natural at roughly 0.5-1.5%. Optimize for topic coverage, not exact-match repetition.
  4. Internal links: 2-5 contextual links to related pages with descriptive anchor text ("standing desk stability test", never "click here"). For architecture across many pages, hand off to internal-linking-mapper.
  5. Image alt text describes the image for a reader who cannot see it - not a keyword slot.

Step 5: Add schema markup where it fits

Add JSON-LD in the <head>; use Article, FAQPage, Product, BreadcrumbList, and HowTo only where the visible content genuinely matches the type - schema describing content that is not on the page invites a manual action.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Standing Desk Buying Guide: Height, Stability, Price",
  "author": { "@type": "Person", "name": "Jordan Lee" },
  "datePublished": "[FILL: ISO date]"
}
</script>

Step 6: Check Core Web Vitals

  • LCP under 2.5s: preload the hero image, serve next-gen formats, avoid render-blocking CSS.
  • CLS under 0.1: explicit width/height on images; reserve space for ads and embeds.
  • INP under 200ms: break up long tasks, defer non-critical JS.

Flag failures and hand deep remediation to web-performance.

Step 7: Check crawl hygiene

  • Canonicalize duplicates with rel="canonical"; pagination uses self-referencing canonicals, not rel=prev/next (deprecated).
  • JS-rendered content: confirm crawlers see the text - server-side rendering or dynamic rendering.
  • Migrations: 301-redirect old URLs one-to-one; never mass-redirect to the homepage.
  • XML sitemap submitted, under 50k URLs per file.

Deliverable

Produce a page audit containing: the intent verdict, rewritten title and meta with character counts shown, the heading outline, a keyword-and-variant map with placement notes, 2-5 internal-link recommendations with anchor text, the JSON-LD block ready to paste, Core Web Vitals pass/fail against the three thresholds, and a prioritized fix list ordered by the layer that fails first.

Do NOT

  • Do not stuff or cloak - the helpful-content system demotes thin, spun pages, and recovery is slower than doing it right.
  • Do not ship a title over 60 characters or with the keyword at the end; truncation hides it exactly where it matters.
  • Do not write meta descriptions past 155 characters - the SERP cuts them mid-sentence.
  • Do not add schema for content the page does not visibly contain.
  • Do not let two pages target the same intent; the split kills both.
  • Do not treat this as site-wide strategy - clustering belongs to keyword-cluster-builder and link architecture to internal-linking-mapper.

Quality bar

  • Title 50-60 chars with the primary keyword front-loaded; meta 140-155 chars with a CTA; both counts stated in the deliverable.
  • The query is answered in the first 100 words.
  • One h1; every h2/h3 earns its place in the outline.
  • 2-5 internal links with descriptive anchors; zero "click here".
  • Schema validates and matches visible content.
  • Each fix in the list names its layer (intent, head, body, schema, vitals, crawl) so the user knows what moves rankings versus click-through.

04 同仓库更多 Skills

SkillMedev
SkillMedev/skills

有氧运动计划

zone-2-cardio-plan

当有人要求制定稳态有氧训练计划、进行有氧基础训练或达到第二区间、安排轻松或耐力型的每周有氧训练、按心率区间训练,或提高静息心率、最大摄氧量或耐力时,可以使用此方案。该方案构建了一个包含训练计划结构、训练方式选择和进度安排的心率区间有氧训练模块。本方案仅提供一般健身指导,不构成医疗建议。请勿用于设计力量或举重训练计划(请使用力量训练计划)、高强度间歇训练 (HIIT) 或循环训练(请使用体能训练和 HIIT 计划),或灵活性/柔韧性训练(请使用灵活性训练计划)。

★ 25
SkillMedev
SkillMedev/skills

youtube-script-writer

Writes retention-engineered long-form YouTube scripts on a hook/body/payoff architecture - a first-30-seconds hook that survives the retention cliff, a beat-sheet body with mini-hooks and bridges, timed pattern interrupts, and a payoff that over-delivers - with B-roll and editing cues marked inline. Use when someone says "script my next video", "my retention graph dies at the start", "tighten this draft", or "outline a video on X". Do NOT use for the 3-second opener of TikTok, Reels, or Shorts - use video-hook-writer instead; do NOT use for spoken voiceover synced to on-screen tutorial actions - use narration-script instead; do NOT use for a sales demo built on a buyer's discovery notes - use demo-script instead; do NOT use to design the thumbnail and title - use thumbnail-concept instead.

★ 25
SkillMedev
SkillMedev/skills

win-back-campaign

Designs segmented win-back email sequences for dormant users - dormancy tiers, a three-beat sequence with a single proportional incentive, and a suppression rule - and measures success by re-activation, not opens. Use when someone says "our users went quiet", "design a win-back campaign", "how do I re-engage lapsed customers", "should we email people who haven't logged in for months", or lifecycle messaging has stopped landing with a lapsed segment. Do NOT use for recovering an unfinished checkout - use abandoned-cart-sequence instead. Do NOT use for diagnosing and fixing why active customers cancel - use churn-reduction instead. Do NOT use for building always-on onboarding or nurture flows - use email-drip-builder instead.

★ 25
SkillMedev
SkillMedev/skills

wikipedia-style

Writes neutral, verifiable, encyclopedic prose following Wikipedia's core content policies and manual of style - NPOV, inline citations, notability-backed claims, and a strict ban on promotional language. Use when someone asks "write this like a Wikipedia article", "draft a Wikipedia page for this company or person", "make this neutral and encyclopedic", or "why does my article draft keep getting rejected". Do NOT use for persuasive or opinion writing - use op-ed-writer instead; for thesis-driven academic papers, use academic-essay; for verifying claims in existing text, use fact-checker.

★ 25
SkillMedev
SkillMedev/skills

whitepapers

Structures and writes authoritative B2B whitepapers - a standalone executive summary, a data-sized problem statement, methodology, evidence-driven findings, recommendations, and a soft call to action - flagging every claim that needs a real citation. Use when a marketer asks "write a whitepaper on this topic", "turn our research into a lead-gen asset", "make this credible enough for executives", or a draft reads like a product pitch instead of analysis. Do NOT use for customer-story-driven proof - use case-study-builder instead; for policy audiences, use policy-brief.

★ 25
SkillMedev
SkillMedev/skills

white-space-analysis

Finds unmet market gaps by ranking jobs-to-be-done on importance versus satisfaction, overlaying them against current solutions and workarounds, and validating that each gap is real, winnable, and worth winning. Use when someone asks "where are the gaps in this market", "what's underserved here", "where should we play next", or is hunting for product, feature, or market-entry opportunities. Do NOT use for profiling competitors and building battle cards - use competitive-intelligence instead; for putting a dollar figure on an identified opportunity - use market-sizing instead; for extracting jobs-to-be-done from raw customer interviews - use jtbd-extractor instead.

★ 25