Agent skill

Metadata Optimizer

by huifer in huifer/claude-code-seo

分析和优化 Next.js 项目的元数据,包括 title、description、Open Graph、Twitter Cards。自动检测 App Router 或 Pages Router,提供长度建议、关键词优化和最佳实践指导。支持中英文双语 SEO 分析。

MITAuto-check passedMarketing & SEO

Install Metadata Optimizer

skills CLI
$ npx skills add huifer/claude-code-seo --skill metadata-optimizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install huifer/claude-code-seo metadata-optimizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/huifer/claude-code-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/metadata-optimizer .claude/skills/metadata-optimizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
metadata-optimizer
GitHub stars
110
Token cost
~1.1k tokens
SKILL.md length
278 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

分析和优化 Next.js 项目的元数据,包括 title、description、Open Graph、Twitter Cards。自动检测 App Router 或 Pages Router,提供长度建议、关键词优化和最佳实践指导。支持中英文双语 SEO 分析。

  • Works in 3 steps: 扫描项目 → 读取元数据 → 评分和报告
  • Marketing & SEO work in your project
  • SKILL.md covers 核心职责, 语言检测, 优化标准 and 工作流程, plus 6 more sections
  • Calls sf

What it does

Metadata Optimizer is an agent skill from huifer/claude-code-seo. 分析和优化 Next.js 项目的元数据,包括 title、description、Open Graph、Twitter Cards。自动检测 App Router 或 Pages Router,提供长度建议、关键词优化和最佳实践指导。支持中英文双语 SEO 分析。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO. It works with X (Twitter) and Next.js. The repository describes itself as: Next.js SEO assistant plugin for Claude Code CLI. Automated SEO audits with 100-point scoring across 6 dimensions. Covers metadata, structured data, E-E-A-T, content strategy… The licence is MIT.

When your agent uses it

  • Marketing & SEO work in your project

Example prompts

  • “/metadata-optimizer”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. 扫描项目
  2. 读取元数据
  3. 评分和报告

What it can do on your machine

Read from SKILL.md and the folder at commit 8b723e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • sf

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Metadata Optimizer loads about 1.1k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 278 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from huifer/claude-code-seo at commit 8b723e4, republished under its MIT licence (© huifer). 278 words, ~1,121 tokens.

Download SKILL.mdSave it as .claude/skills/metadata-optimizer/SKILL.md (or your agent's skills folder).
name
metadata-optimizer
description
分析和优化 Next.js 项目的元数据,包括 title、description、Open Graph、Twitter Cards。自动检测 App Router 或 Pages Router,提供长度建议、关键词优化和最佳实践指导。支持中英文双语 SEO 分析。
allowed-tools
Read, Grep, Glob

你是 Next.js 元数据优化专家,专注于分析网站元数据的 SEO 优化。

核心职责

当用户在 Next.js 项目中工作,或者请求 SEO 帮助时,你会:

  1. 自动检测项目结构

    • 识别是 App Router (app/ 目录) 还是 Pages Router (pages/ 目录)
    • 扫描所有页面和组件文件
    • 定位元数据定义位置
  2. 分析现有元数据

    • 检查 <title> 标签或 metadata 对象
    • 检查 <meta name="description">
    • 检查 Open Graph 标签(og:title, og:description, og:image, og:url)
    • 检查 Twitter Cards 标签
  3. 提供优化建议

    • Title 长度建议
    • Description 长度建议
    • 关键词优化
    • 缺失的元数据标签

语言检测

在分析前,检测内容语言:

中文内容特征:

  • 中文字符比例 > 30%
  • HTML lang="zh-CN" 或 lang="zh"
  • URL 包含 /zh/ 或 /cn/

英文内容特征:

  • 中文字符比例 < 10%
  • HTML lang="en" 或 lang="en-US"
  • URL 包含 /en/

优化标准

Title 标签

中文:

  • 最佳长度:20-30 个字符
  • 最大长度:40 个字符(约 80px 宽度)
  • 格式:主关键词 | 次要关键词 | 品牌名称
  • 示例:管道工服务 | 24小时紧急维修 | SF Plumbing

英文:

  • 最佳长度:50-60 个字符
  • 最大长度:75 个字符(约 600px 宽度)
  • 格式:Primary Keyword - Secondary Keyword | Brand Name
  • 示例:Plumbing Services | 24/7 Emergency Repair | SF Plumbing
Meta Description

中文:

  • 最佳长度:70-80 个字符
  • 最大长度:100 个字符
  • 格式:包含关键词的行动号召 + 独特价值主张
  • 示例:提供专业的管道维修服务。24小时紧急服务,覆盖旧金山湾区。立即致电 (415) 555-0123。

英文:

  • 最佳长度:150-160 个字符
  • 最大长度:180 个字符
  • 格式:Action-oriented with keywords + unique value proposition
  • 示例:Professional plumbing services in San Francisco. 24/7 emergency service, covering the Bay Area. Call (415) 555-0123 now.
Open Graph 标签

必需标签:

html
<meta property="og:title" content="页面标题">
<meta property="og:description" content="页面描述">
<meta property="og:image" content="分享图片 URL">
<meta property="og:url" content="页面 URL">
<meta property="og:type" content="website">
Twitter Cards 标签

推荐使用 Summary Card with Large Image:

html
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="页面标题">
<meta name="twitter:description" content="页面描述">
<meta name="twitter:image" content="分享图片 URL">

工作流程

1. 扫描项目
使用 Glob 查找所有页面文件:
- App Router: app/**/page.tsx, app/**/page.js
- Pages Router: pages/**/*.tsx, pages/**/*.js
- 组件: components/**/*.tsx, components/**/*.js
2. 读取元数据
对每个文件:
1. 检查 metadata 对象(App Router)
2. 检查 Head 组件(Pages Router)
3. 检查 <title> 和 <meta> 标签
3. 评分和报告

对每个页面生成报告:

markdown
## 页面分析:[文件路径]

### ✅ 优点
- Title 存在且优化良好
- Description 完整
- 包含完整的 OG 标签

### ⚠️  需要改进
- Title 长度:65 字符(建议:50-60)
- 缺少 Twitter Cards 标签
- Description 可以更具体

### ❌ 缺失项
- og:image 未定义
- og:url 未定义

### 建议
1. 缩短 Title 到 55 字符以内
2. 添加 Twitter Cards 标签以提升社交媒体分享效果
3. 添加 OG 图片以改善社交预览

双语支持实现

根据语言调整建议

检测到中文内容时:

markdown
语言:中文
- Title 建议:20-30 字符(当前:35 字符)⚠️
- Description 建议:70-80 字符(当前:50 字符)✓
- 关键词:在 Title 中添加主要关键词

检测到英文内容时:

markdown
Language: English
- Title 建议:50-60 characters (current: 55) ✓
- Description 建议:150-160 characters (current: 120) ⚠️
- Keywords: Consider adding secondary keyword

检测到双语内容时:

markdown
语言:双语(中文 + 英文)
- 确保使用 hreflang 标签
- 检查语言切换功能
- 验证翻译质量

自动触发条件

在以下情况下自动激活:

  1. 用户打开或编辑包含元数据的文件
  2. 用户运行 /seo-check 或 /seo-audit 命令
  3. 用户询问关于元数据的问题
  4. 检测到 Next.js 项目中的页面文件

输出格式

简洁模式(默认)
📊 元数据分析结果

✅ 12 个页面已扫描
⚠️  5 个页面需要优化
❌ 2 个页面缺少关键元数据

优先修复:
1. /about - 缺少 Description
2. /blog/[slug] - Title 过长(75 字符)
3. /contact - 缺少 OG 标签
详细模式

当用户使用 --verbose 或请求详细分析时,提供完整的逐页分析报告。

示例对话

用户: "检查我的 Next.js 项目元数据"

你的回复:

我将扫描你的 Next.js 项目并分析元数据...

🔍 检测到:Next.js App Router
📁 扫描目录:app/
📄 发现 15 个页面

元数据分析完成:

✅ 优秀的页面(10/15)
  - /, /about, /services, /blog, /contact...

⚠️  需要优化的页面(4/15)
  1. /blog/[slug] - Title: 68 字符(建议:50-60)
  2. /services/plumbing - 缺少 Description
  3. /products - 缺少 OG 图片
  4. /team - 缺少 Twitter Cards

❌ 严重问题的页面(1/15)
  - /pricing - 完全缺少元数据

建议优先处理 /pricing 页面,它完全没有元数据,会严重影响 SEO。

需要我为特定页面生成优化的元数据代码吗?

最佳实践建议

在分析完成后,提供以下建议:

  1. 一致性 - 确保所有页面使用一致的元数据格式
  2. 唯一性 - 每个页面的 Title 和 Description 应该是唯一的
  3. 关键词 - 在 Title 和 Description 中自然地包含目标关键词
  4. 品牌 - 在 Title 末尾包含品牌名称(如果空间允许)
  5. 行动号召 - 在 Description 中包含行动号召
  6. 社交 - 为所有页面添加完整的 OG 和 Twitter Cards 标签
  7. 图片 - 使用高质量的 OG 图片(推荐:1200x630px)
  8. 测试 - 使用 Facebook Sharing Debugger 和 Twitter Card Validator 测试

技术提示

  • 使用 Glob 模式:app/**/*.{tsx,ts,jsx,js}
  • 使用 Grep 搜索:<title>|<meta|metadata
  • 检查文件扩展名以确定路由类型
  • 优先扫描 page.tsx 和 page.js 文件
  • 忽略 _ 开头的目录(Next.js 约定)

© huifer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/metadata-optimizer of huifer/claude-code-seo.

Open the folder on GitHubat commit 8b723e4

Compare with similar skills

Metadata Optimizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Metadata Optimizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Metadata Optimizer this skillhuifer/claude-code-seo110—~1.1kAutomated safety check: PassMIT
SEO FundamentalsDanielPodolsky/ownyourcode2901 repos~1.4kAutomated safety check: PassMIT
SEOgridaco/grida2.7k—~2.1kAutomated safety check: PassApache-2.0
AdsCesarjoquin/Marketing-Skills2001 repos~3.5kAutomated safety check: PassMIT
Meta Tags Optimizernowork-studio/notfair-plugin3.9k1 repos~2.7kAutomated safety check: PassMIT
Adscoreyhaines31/marketingskills54k1 repos~7.8kAutomated safety check: PassMIT

Similar skills

  • SEO Fundamentals

    DanielPodolsky/ownyourcode

    Reviews SEO including meta tags, semantic HTML, and Open Graph.

    290 GitHub starsUsed in 1 repo~1.4k tokens
    Marketing & SEOAuto-check passed
  • SEO

    gridaco/grida

    SEO best practices for the Grida project across Next.js pages, blog posts, and documentation.

    2.7k GitHub stars~2.1k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Ads

    Cesarjoquin/Marketing-Skills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    200 GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • Meta Tags Optimizer

    nowork-studio/notfair-plugin

    Writes and improves title tags, meta descriptions, Open Graph and Twitter card tags for click-through, with character counts and A/B test variants.

    3.9k GitHub starsUsed in 1 repo~2.7k tokens
    Marketing & SEOAuto-check passed
  • Ads

    coreyhaines31/marketingskills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    54k GitHub starsUsed in 1 repo~7.8k tokens
    Marketing & SEOAuto-check passed
  • Influencer Discovery

    tigerless-labs/influencer-discovery

    Find the bloggers/creators who can help promote your work, capture their contact info, and append them to the target sheet in Google Sheets.

    211 GitHub stars~2.5k tokensUpdated 15 days ago
    Marketing & SEOAuto-check: notes

More from huifer/claude-code-seo

All 12 skills in this repo
  • AI Content Creator

    huifer/claude-code-seo

    AI 内容创作专家,生成高质量的 SEO 和 GEO 优化内容,支持多种内容类型和风格. An agent skill from huifer/claude-code-seo.

    110 GitHub stars~1.7k tokensUpdated 9 mo ago
    Auto-check: notes
  • Content Optimizer

    huifer/claude-code-seo

    分析博客文章和页面内容的质量,包括标题结构、关键词密度、可读性、内链机会、图片 alt 文本等。提供 E-E-A-T 权威性建设(Experience, Expertise, Authoritativeness, Trustworthiness)和内容策略建议,包括支柱页面、集群内容、作者权威性、关键词蚕食检测、Featured Snippets 优化、多媒体内容优化。

    110 GitHub stars~4k tokensUpdated 9 mo ago
    Auto-check passed
  • Geo Optimizer

    huifer/claude-code-seo

    生成式引擎优化专家,分析和优化内容在 AI 搜索引擎(ChatGPT、Claude、Perplexity、Google SGE)中的可见性和引用率。

    110 GitHub stars~650 tokensUpdated 9 mo ago
    Auto-check: notes
  • Guest Blogger

    huifer/claude-code-seo

    基于项目内容分析主题和关键词,生成客座博客搜索策略。提供 Google 高级搜索语法、客座博客资源列表(从 resources/guest-blog-sources.md 读取)和投稿邮件模板(从 templates/guest-blog-pitch.md 读取)。自动评估客座博客质量(DA、相关性、流量),提供个性化的投稿建议和优先级排序。

    110 GitHub stars~2.8k tokensUpdated 9 mo ago
    Auto-check passed
  • Local SEO

    huifer/claude-code-seo

    本地 SEO 分析和优化专家。自动检测项目是否需要本地 SEO,分析 NAP(Name, Address, Phone)一致性、本地关键词优化、Google Business Profile (GBP) 优化和本地结构化数据生成。提供本地商家搜索引擎排名优化建议,包括 NAP 标准化、本地关键词策略、GBP 完整性检查、评论策略、地图嵌入和本地 SEO 审计。

    110 GitHub stars~2.6k tokensUpdated 9 mo ago
    Auto-check passed
  • Off Page SEO

    huifer/claude-code-seo

    站外 SEO 分析和策略专家。分析外链质量和数量、竞争对手外链策略、品牌提及、社交信号等。提供 9 种外链建设策略(客座博客、断链建设、摩天大楼技术、HARO、行业目录、品牌提及、图片外链、社交信号、外链跟踪)。包含外链质量评估标准、跟踪管理系统和可执行的行动计划。

    110 GitHub stars~1.9k tokensUpdated 9 mo ago
    Auto-check passed

Categories

Questions about Metadata Optimizer

What does Metadata Optimizer do?

分析和优化 Next.js 项目的元数据,包括 title、description、Open Graph、Twitter Cards。自动检测 App Router 或 Pages Router,提供长度建议、关键词优化和最佳实践指导。支持中英文双语 SEO 分析。. Metadata Optimizer is an agent skill from huifer/claude-code-seo.

When should I use Metadata Optimizer?

Metadata Optimizer fits situations like: marketing & SEO work in your project.

How do I install Metadata Optimizer in Claude Code?

Run `npx skills add huifer/claude-code-seo --skill metadata-optimizer -a claude-code`. Or copy the skill folder (skills/metadata-optimizer in huifer/claude-code-seo) into .claude/skills/metadata-optimizer in your project. Claude Code loads it when a task matches its description.

How do I install Metadata Optimizer in Codex?

Run `npx skills add huifer/claude-code-seo --skill metadata-optimizer -a codex`. Or copy the skill folder (skills/metadata-optimizer in huifer/claude-code-seo) into .agents/skills/metadata-optimizer in your project. Codex loads it when a task matches its description.

Can I use Metadata Optimizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add huifer/claude-code-seo --skill metadata-optimizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/metadata-optimizer, .gemini/skills/metadata-optimizer, .github/skills/metadata-optimizer and .opencode/skills/metadata-optimizer in your project.

What does Metadata Optimizer need to run?

Going by SKILL.md and its folder, Metadata Optimizer needs the command-line tools its instructions call (sf). Its frontmatter pre-approves these tools: Read, Grep, Glob.

Does Metadata Optimizer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Metadata Optimizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Metadata Optimizer use?

Metadata Optimizer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Metadata Optimizer use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Metadata Optimizer?

Skills that share tags, products or a category with Metadata Optimizer: SEO Fundamentals (DanielPodolsky/ownyourcode, 290 stars), SEO (gridaco/grida, 2.7k stars), Ads (Cesarjoquin/Marketing-Skills, 200 stars) and Meta Tags Optimizer (nowork-studio/notfair-plugin, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Metadata Optimizer?

huifer (a GitHub user) maintains it in huifer/claude-code-seo, which has 110 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on January 4, 2026.

Source: huifer/claude-code-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.