Communitygithub.com

asodevapp/skills

用于用户想要编写、重写、优化、比较、验证或批量填充 ASO.dev 中的 Apple App Store 或 Google Play 元数据(标题、副标题、关键词字段、描述、推广文本、简短描述、完整描述或“新内容”)时使用。

skills 是什么?

此技能专注于优化移动应用商店元数据(Apple App Store 和 Google Play),通过数据驱动的方法平衡搜索可见性、转化率、清晰度和合规性。它支持标题、副标题、关键词、描述、推广文本等所有关键字段的编写、重写、优化、比较、验证及批量填充。 该技能首先通过 `current-metadata-fetch` 读取当前值,利用 `keyword-research` 和 `keyword-coverage` 进行关键词研究,并支持多语言环境下的元数据起草。其工作流程包括定位分析、字段起草、使用 `validate_ai_companion_data` 进行合规性验证,以及通过 `bulk_fill` 或 `bulk_fill_google` 直接应用到 ASO.dev 编辑器。 核心质量门控要求输出“复制即用”的元数据:无占位符、无未解决的括号、精确字符数且符合平台限制。对于标题和副标题,它会提供多个优化选项,并建议最佳方案。该技能还深入集成 ASO.dev 编辑器上下文(如智能元数据编辑器、批量编辑器、跨本地化分析、版本历史),以确保草稿基于实际数据而非猜测。 优化框架覆盖苹果(Apple)和谷歌(Google)的平台限制与搜索角色:例如,标题和副标题被 Apple 搜索索引(最多30个字符),关键词字段(最多100个字符,隐藏但被索引),而描述主要用于转化(最多4000个字符,不被 App Store 搜索索引)。Google Play 中,标题(30字符)、简短描述(80字符)和完整描述(4000字符)均被索引且支持搜索。技能包含针对标题结构、Apple 关键词字段、描述写作(提供建议结构如“钩子-主要好处-关键功能-工作原理-信任证明-行动号召”)以及推广文本的使用指南。它特别强调避免重复关键词、禁止使用竞争对手商标或未经证实的声明,并严格遵循字符预算。最终输出以 Markdown 表格形式呈现诊断、推荐元数据、替代方案、关键词覆盖矩阵及前后对比,并可直接注入 `bulk_fill` 负载进行应用。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/asodevapp/skills/tree/HEAD/skills/metadata-editor

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

元数据优化

编写在搜索可见性、转化率、清晰度和合规性之间取得平衡的 App Store 和 Google Play 元数据。

工作流程

  1. 使用 current-metadata-fetch 读取当前值。
  2. 如果定位、语气、受众或禁止声明相关,则使用 get_project_context。
  3. 确定平台、国家、地区、目标关键词和页面类型:默认列表、发布元数据、CPP/PPO 草稿或 Google 列表。
  4. 如果目标关键词缺失,先使用 keyword-research;使用 keyword-coverage 分配选定的关键词。
  5. 仅起草所请求的地区和字段。
  6. 使用 appMetadata 或 googleMetadata 通过 validate_ai_companion_data 进行验证。
  7. 如果用户要求应用/填充,请使用 bulk_fill 或 bulk_fill_google。

质量门控

  • 推荐的字段必须是复制即用的:无占位符、无未解决的括号、精确的字符数,并遵守平台特定限制。
  • 如果缺少应用定位、受众、盈利模式、证明、支持 URL 或目标关键词,请询问或在分析中标记差距;不要将其凭空添入最终元数据。
  • 为高影响力的字段提供备选方案,但明确标记一个推荐选项。
  • 将实施步骤与元数据文案分开处理,以便用户无需清理即可直接粘贴字段。

ASO.dev 编辑器上下文

当 ASO.dev 编辑器数据可用时,请使用它而不是猜测:

  • 智能元数据编辑器:当前值、长度检查、预览、先前版本复用/回滚、导入/导出、Fastlane、直接 App Store Connect 保存和审核提交上下文。
  • 批量编辑器:所有本地化、重复检测、从过往版本复制、AI/Google/DeepL 翻译状态。
  • 跨本地化:按国家-本地化组合的标题/副标题/关键词覆盖。
  • 时间线/变更日志:用于前后对比的先前元数据和发布历史。
  • 版本工作流:应用版本、发布类型、构建选择、年龄分级、服务器通知、主要本地化以及本地化添加/删除状态可能影响可以安全起草或填充的内容。

平台限制

Apple App Store

字段限制搜索角色
title30被索引,权重最高
subtitle30被索引
keywords100 个连接字符被索引,隐藏
promotionalText170转化,不被索引,可在不更新应用版本时更改
description4000转化,不被 App Store 搜索索引
whatsNew4000更新沟通

Google Play

字段限制搜索角色
title30被索引
shortDescription80被索引且可见
fullDescription4000被索引和转化

优化框架

标题

  • 尽可能自然地包含最强的目标关键词。
  • 仅当品牌是知名品牌且具有可观的搜索需求或信任价值时,才以品牌优先。
  • 对于知名度较低的应用,以最重要的功能关键词/意图开头,并在仍需要包含品牌时将品牌置于结尾;这有助于 App Store 建议和短语首先从优先级更高的关键词中形成。
  • 在搜索结果中保持可读性。
  • 除非必要,否则不要浪费字符在法律标记上。
  • 优化标题时提供 3 个选项。

好的结构:

  • 主要关键词: 好处短语
  • 主要关键词 - 次要意图
  • 主要关键词 by 品牌
  • 知名品牌: 主要关键词

Apple 副标题

  • 添加次要关键词和好处语言。
  • 除非有明确的战略理由,否则不要重复标题关键词中的单词。
  • 使其有利于转化,而不仅仅是关键词列表。
  • 优化副标题时提供 3 个选项。

Apple 关键词字段

  • 逗号分隔,无空格。
  • 在 MCP 负载中内部视为数组。
  • 除非有意为之,否则不要重复已在标题/副标题中的单词。
  • 除非数据支持复数,否则优先使用单数形式。
  • 不要包含应用名称、竞争对手品牌、app 或 free。
  • 首先按相关性排序,然后按受欢迎程度/机会排序。

Apple 描述

  • App Store 搜索不索引它;主要为转化而编写。
  • 前 2-3 行应在用户点击“更多”之前传达核心用户价值。
  • 在功能列表之前使用好处。
  • 仅包含真实的证明:用户提供的评分、奖项、媒体报道、使用数字或推荐信。
  • 除非品牌语气支持,否则不要添加表情符号。

建议结构:

  1. 钩子
  2. 主要好处
  3. 关键功能
  4. 工作原理
  5. 信任/证明
  6. 行动号召

Google 描述

  • 平衡转化和自然关键词覆盖。
  • 在第一段中前置最相关的术语;在展开之前,前 ~250 个字符应能独立存在。
  • 使用变体和同义词;不要堆砌关键词。
  • 使用项目符号和换行符以便扫描。
  • 保持密度自然且可读。

推广文本

用于及时信息:

  • 功能发布
  • 季节性活动
  • 应用内活动
  • 限时内容
  • 真实的奖项或里程碑

除非当前数据或用户确认,否则不要硬编码价格、日期、折扣或可用性。

Apple 规则

  • Apple 关键词应逗号分隔,无空格。
  • 除非有意为之,否则避免在标题、副标题和关键词之间重复关键词单词。
  • 不要添加竞争对手商标或未经证实的声明。
  • 除非明确要求,否则不要更改 URL、隐私文本或法律文案。
  • 标记诸如“欢迎使用...”或通用的“最佳应用...”之类的弱钩子。
  • 仅当添加字符会提高相关性或转化率时,才标记未使用的字符预算。

输出

# 元数据优化包

应用:
平台:
国家:
地区:
目标关键词:

## 诊断
| 地区 | 字段 | 问题 | 修复 |
|---|---|---|---|

## 推荐元数据
### locale-code
| 字段 | 推荐内容 | 字符数 | 覆盖的关键词 | 理由 |
|---|---:|---|---|

## 备选方案
| 字段 | 选项 | 文案 | 字符数 | 角度 |
|---|---:|---|

## 关键词覆盖矩阵
| 关键词 | 标题 | 副标题/简短描述 | 关键词字段 | 描述 | 备注 |
|---|---|---|---|---|---|

## 前后对比
| 字段 | 当前 | 推荐 | 改进 |
|---|---|---|---|

## 验证
- 字符限制:
- 关键词重复:
- 关键词研究来源:
- 未经证实的声明:
- URL/隐私/法律未更改:
- MCP 验证:
- 准备好 `bulk_fill`:

填充负载规则

填充 Apple 元数据时,发送:

{
  "locales": ["en-US"],
  "fields": ["title", "subtitle", "keywords"],
  "data": {
    "en-US": {
      "title": "...",
      "subtitle": "...",
      "keywords": ["keyword", "keyword2"]
    }
  }
}

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

asodevapp/skills

Use when the user wants Google Play Store or Android ASO: Play listing title, short description, full description, keyword strategy, feature graphic, screenshots, ratings/reviews, Play Store Experiments, localization, or Google Play-specific metadata via ASO.dev.

asodevapp/skills

Use when the user wants to interpret ASO.dev Measurements or App Store Connect metrics: downloads, impressions, product page views, conversion, revenue, retention, sessions, active devices, ratings, reviews, release markers, experiment impact, or before/after ASO performance.

asodevapp/skills

Use to read, create, or update ASO.dev per-app project context before metadata, localization, keywords, screenshots, IAP, subscriptions, pricing, In-App Events, nominations, or review work.

asodevapp/skills

Use when the user wants a full ASO audit or health check for an app: metadata, keyword coverage, cross-localization, screenshots, reviews, ratings, update history, In-App Events, IAP/subscriptions, CPP/PPO, competitors, rankings, or ASO.dev ASO Check interpretation.

asodevapp/skills

Use when the user wants App Store Custom Product Pages, Product Page Optimization, A/B testing, conversion rate optimization, product page variants, screenshot/icon/app preview tests, campaign pages, keyword/ad alignment, or CPP/PPO drafts in ASO.dev.

asodevapp/skills

Use when the user wants to create, plan, audit, optimize, localize, or fill App Store In-App Events in ASO.dev: event cards for Today/Games/Apps tabs, search, product pages, re-engagement, challenges, competitions, live events, premieres, seasons, major updates, and special events.

asodevapp/skills

Use for App Store consumable and non-consumable In-App Purchases: metadata, localization, pricing/availability notes, promoted IAP readiness, validation, and ASO.dev local MCP fill when that surface is available.

asodevapp/skills

Use for keyword ideas, keyword prioritization, keyword/search query CSV-derived shortlists, competitor keyword gaps, Search Ads Popularity interpretation, and keyword distribution across metadata/locales.

asodevapp/skills

Use when the user wants to analyze, respond to, report, or improve App Store reviews and ratings in ASO.dev: negative reviews, ratings trend, review replies, review complaints, review health, product insights, uploaded review CSV analysis, sentiment, missing feature requests, or rating prompt strategy.

asodevapp/skills

Use to prepare screenshot copy, screenshot order, creative briefs, and App Store / Google Play visual messaging.

相关技能