Use Case Pattern Page Builder

VerifiedSafe

Create new use-case patterns in the Adobe Experience Platform Blueprint repository, generate Markdown files, and update cross-references.

Sby Skills Guide Bot
DocumentationIntermediate
7/23/2026
Claude Code
#adobe-experience-platform#documentation-generation#content-workflow#markdown#cross-references

Recommended for

Automated summary

Guides creation of a new Adobe Experience Platform Blueprint use case pattern page, from collecting requirements through generating the Markdown file and updating the TOC.md and overview.md cross-reference pages.

Strengths

  • Defines a clear four-phase workflow from information gathering to final validation.
  • Enforces a complete template structure with YAML frontmatter, required content sections, and business objective links.
  • Updates cross-references in TOC.md and overview.md while preserving existing category sections and formatting.
  • Includes validation checks for links, file naming, TOC placement, and frontmatter completeness.

Limitations

  • Highly specific to the Adobe Experience Platform Blueprint repository and its predefined categories.
  • Requires the user to provide extensive pattern information before content generation can proceed.
  • The exl-id is only a placeholder, and some Experience League link checks remain manual.
When to use it

Use when adding a new use case pattern page to the Adobe Experience Platform Blueprint repository and updating its navigation pages.

When not to use it

Do not use for general documentation writing or repositories outside Adobe Experience Platform Blueprint.

Security analysis

Safe
Quality score90/100

The skill is a content generation guide for creating Markdown documentation in a repository. It does not instruct execution of shell commands, network requests, data exfiltration, destructive actions, or obfuscated code. It only collects information from the user and writes/edits local Markdown files using standard file operations.

No concerns found

How this analysis is made

Examples

Create a personalization pattern page
Create a new Adobe Experience Platform Blueprint use case pattern for 'event-triggered messaging' in the personalization category. Ask me for the required details first, then generate the Markdown file and update TOC.md and overview.md.
Add an audience activation pattern
Add a use case pattern page for 'real-time profile activation' under audience-building-activation. Use the pattern template, create the file in the correct folder, update the cross-references, and validate the business objective links.
Update Blueprint navigation
I need to add a new campaign management and orchestration use case pattern to the Adobe Experience Platform Blueprint site. Collect the required information, generate the pattern page, and update the TOC and overview tables.

name: use-case-pattern-page-builder description: 为Adobe Experience Platform Blueprint存储库创建新的用例模式内容指南。 在添加新用例模式、创建实施指导内容或用户提及向Blueprint站点添加模式时,请使用此技能。 处理完整的工作流程:收集模式信息,生成具有正确模板结构的Markdown文件,并更新所有交叉引用页面(TOC.md、overview.md)。 source-git-commit: 349d26f612d4002d1de3d27c7f893bd63ac467a3 workflow-type: tm+mt source-wordcount: '923' ht-degree: 94%


用例模式页面生成器

此技能可指导Adobe Experience Platform Blueprint存储库创建新的用例模式。 它处理整个工作流:从用户那里收集模式信息,生成具有正确模板结构的Markdown内容文件,并更新所有交叉引用页面,以便发现新模式。

开始之前,请阅读以下参考文件,以了解完整的模板结构和要更新的页面核对清单:

  • references/pattern-template.md — 带占位符值的完整Markdown模板
  • references/pages-to-update.md — 添加模式时必须更新的页面清单

第1阶段:信息收集

在生成任何文件之前询问用户以收集所有必需的信息。 询问以下问题,并且在提供每个项目或明确延迟提供每个项目之前,不要继续生成内容。

所需信息

  1. 模式名称 — 易于用户识别的标题(例如,“事件触发的消息传递”)。

  2. 类别 — 刚好是以下之一:

    • audience-building-activation
    • personalization
    • campaign-management-orchestration
    • analysis
    • conversational-experience
  3. 主要功能描述 — 描述此模式的用途的单个句子(用于概述表和frontmatter描述)。

  4. 核心Adobe解决方案 — Adobe产品是此模式的中心。 根据需要从Journey Optimizer、Real-Time Customer Data Platform、Experience Platform、Customer Journey Analytics、Brand Concierge、Journey Optimizer B2B edition、Real-Time CDP B2B edition或其他中进行选择。

  5. 支持的业务目标 — 来自/help/blueprints/business-objectives/下的现有集的一个或多个业务目标。 每个名称都应包括目标名称、类别子文件夹和文件名。 在生成内容之前,请验证引用的文件是否存在。

  6. 战术用例示例 — 6-10个项目符号场景,描述如何在不同业务环境中应用此模式。 每个模板都应该有一个粗体方案名称,后跟一个说明。

  7. KPI — 包含三列的表:KPI(名称)、描述(度量值)、度量(公式或方法)。

  8. 引用链接 — 引用指向主要Experience League文档的链接,这些文档涵盖了用例模式的应用程序和功能。

可选,但推荐

  • 用例概述段落(3-5段;如果未提供,则从其他信息中草稿)
  • 应用程序列表,其中包含每个Adobe应用程序的角色描述

如果用户不提供可选物料,则根据模式类别、解决方案和执行计划生成合理的默认值。

阶段2:内容生成

在以下路径生成模式Markdown文件:

/help/blueprints/use-case-patterns/{category}/{kebab-case-pattern-name}.md

文件名必须使用从模式名称派生的kebab大小写。 例如,“事件触发的消息传递”变为event-triggered-messaging.md。

使用references/pattern-template.md中的模板并使用收集的信息填写所有占位符值。 生成的文件必须包含模板中的每个部分:

  1. YAML frontmatter — title、description、solution(逗号分隔)、exl-id(生成类似xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx的UUID占位符 — 发布团队将分配实际占位符)。

  2. 打开部分 — # {Pattern name}标题,后面是介绍性段落和“使用本指南了解……” 句子。

  3. 用例模式 — 描述段落和执行计划。

  4. 用例概述 — 3-5个段落,描述模式范围、适用时间、操作和不操作以及典型利益相关者是谁。

  5. 关键业务目标 — 每个目标都作为链接标题,带有简要说明和KPI摘要行。

  6. 战术用例示例 — 6-10个方案的项目符号列表。

  7. 关键绩效指标 — 包含KPI、说明和度量列的表。

  8. 应用程序 — 具有[!DNL ...]格式和描述的Adobe应用程序列表。

阶段3:交叉引用更新

生成图案文件后,更新以下文件。 请阅读references/pages-to-update.md以了解详细核对清单。

TOC.md

文件: /help/blueprints/TOC.md

在正确的类别部分下添加新条目。 类别映射到以下目录部分:

| 类别概要 | 目录章节标题 | | --- | --- | | audience-building-activation | + Audience Building & Activation{#audience-building-activation} | | personalization | + Personalization{#personalization-patterns} | | campaign-management-orchestration | + Campaign Management & Orchestration{#campaign-orchestration-patterns} | | analysis | + Analysis{#analysis-patterns} | | conversational-experience | + Conversational Experience{#conversational-experience-patterns} |

条目格式为:

    + [{{Pattern Title}}](/help/blueprints/use-case-patterns/{{category}}/{{filename}}.md)

在匹配部分的最后一个现有条目之后添加新条目。 保留确切的缩进(+前有四个空格)。

“概述”页面

文件: /help/blueprints/use-case-patterns/overview.md

向正确的类别表添加新行。 格式为:

| [{{Pattern Title}}]({{category}}/{{filename}}.md) | {{Primary capability description}} | [!DNL {{Solution1}}], [!DNL {{Solution2}}] |

在匹配类别表中最后一个现有行之后添加新行。

第4阶段:验证

创建并更新所有文件后,请验证以下各项:

  1. 业务目标链接 — 模式文件中的每个业务目标链接指向/help/blueprints/business-objectives/下的现有文件。 使用glob或read确认每个目标文件都存在。

  2. 目录条目位置 — 新的目录条目位于正确的类别部分中,并使用正确的缩进和路径格式。

  3. 概述表行 — 新的概述行位于正确的类别表中,并且遵循与现有行相同的列格式。

  4. 文件命名 — 模式文件名使用kebab大小写,并与TOC.md和overview.md中引用的路径匹配。

  5. Frontmatter完整性 — 模式文件在其YAML frontmatter中包含标题、描述、解决方案和exl-id。

  6. Experience League链接 — 抽查所有Experience League URL是否合理(以https://experienceleague.adobe.com/zh-hans开头)。

向用户报告任何验证失败,并在考虑任务完成之前修复它们。

注释

  • 在表和正文文本中,始终使用用于Adobe产品名称的[!DNL ...]语法,遵循现有模式文件的约定。
  • frontmatter中的exl-id应为占位符UUID。 发布管道分配实际值。
  • 如果用户希望一次创建多个模式,请对每个模式重复第2-4阶段,但在第1阶段中收集所有信息。
  • 如果需要上述列表中不存在的新类别,请警告用户TOC.md和overview.md需要创建新分区,并作为单独的步骤进行处理。

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/use-case-pattern-page-builder-mrx3xzwu/download' --output '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md.part' && mv '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md.part' '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code
test -f '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md' && test -s '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/use-case-pattern-page-builder' && cp -R '.skill-downloads/use-case-pattern-page-builder-mrx3xzwu' '.claude/skills/use-case-pattern-page-builder'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation
openskills install './.skill-downloads/use-case-pattern-page-builder-mrx3xzwu'

openskills read 'use-case-pattern-page-builder-mrx3xzwu'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/use-case-pattern-page-builder-mrx3xzwu/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills