# Applying CMS brand Human Guide

## What This Is For
Extracts, retrieves, and applies CMS brand guidelines (voice, tone, style, colors, typography) to generated content. It gives the agent a clearer input/output frame for brand and messaging: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the Applying CMS brand agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for applying CMS brand.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the Applying CMS brand guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- Apply their brand voice/tone to generated content
- Find and use brand guidelines stored in Salesforce CMS
- Search for an existing brand in their org
- Get brand instructions for content generation
- Ensure generated content matches their brand identity
- Apply brand styling, tone, or voice to a page, component, or app
- Search for images or media (use experience-content-media-search skill)
- Create a new brand from scratch
- Edit brand definitions in CMS
- Generate logos or visual brand assets
- **Search for available brands** (if brand is not already identified)
- **Extract brand instructions** for the selected brand

## Decision Points And Nuance
The original skill emphasizes: Scope, Before You Start, Workflow Overview, Step 1: Determine Brand Context, Step 2: Search for Brands, Presenting Brand Results, Step 3: Extract Brand Instructions, What Brand Instructions Contain, Error Handling, Key Principles.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- DO NOT use this skill when the user wants to:
- CRITICAL: You must retrieve brand instructions BEFORE applying any brand.
- **Never generate content first and retrofit branding later.** Brand instructions must inform content generation from the start.
- > `search_media_cms_channels` directly here is correct and intentional — do not
- When the user replies with their selection, do NOT perform another search —
- **Never auto-select a brand without confirmation.** Always wait for user choice.
- | Content Rules | Dos and don'ts for content generation |
- | Permission denied | "You don't have permission to access CMS brands. Ensure you have Managed Content Authoring permission." |

## Copy-And-Paste Prompt
```text
Use the Applying CMS brand human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the forcedotcom/sf-skills skill entry for `experience-cms-brand-apply`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# Applying CMS Brand

Universal skill for searching, extracting, and applying CMS brand guidelines to generated content.

## Scope

**This skill is for APPLYING existing brand guidelines from Salesforce CMS to content you generate.**

**Use this skill when the user wants to:**
- Apply their brand voice/tone to generated content
- Find and use brand guidelines stored in Salesforce CMS
- Search for an existing brand in their org
- Get brand instructions for content generation
- Ensure generated content matches their brand identity
- Apply brand styling, tone, or voice to a page, component, or app

**DO NOT use this skill when the user wants to:**
- Search for images or media (use experience-content-media-search skill)
- Create a new brand from scratch
- Edit brand definitions in CMS
- Generate logos or visual brand assets

## Before You Start

**CRITICAL: You must retrieve brand instructions BEFORE applying any brand.**

When a user requests branded content:

1. **Search for available brands** (if brand is not already identified)
2. **Extract brand instructions** for the selected brand
3. **Apply brand guidelines** to all content you generate

**Never generate content first and retrofit branding later.** Brand instructions must inform content generation from the start.

## Workflow Overview

Copy this checklist and track your progress:

```text
CMS Branding Progress:
- [ ] Step 1: Determine if brand is already identified or needs search
- [ ] Step 2: Search for brands (if needed) and present options to user
- [ ] Step 3: Extract brand instructions for the selected brand
```

## Step 1: Determine Brand Context

Check if the user has already specified which brand to use:

**Brand is known** (user named it, or only one brand exists):
- Skip to Step 3 (Extract Brand Instructions)

**Brand is unknown** (user says "apply my brand" without specifying which):
- Proceed to Step 2 (Search for Brands)

## Step 2: Search for Brands

**Tool:** `search_media_cms_channels`

Brands are stored as CMS content of type `sfdc_cms__brand`. Search for them by
querying the CMS channels with the brand content type.

> **Note:** Brand content search (`contentTypeFqn=sfdc_cms__brand`) is explicitly
> excluded from the `experience-content-media-search` skill's scope. Calling
> `search_media_cms_channels` directly here is correct and intentional — do not
> route brand search through `experience-content-media-search`.

**Process:**

1. **Determine search query** — Use the user's keyword. Brand search matches on
   brand title and description.
2. **Build the request** with the fixed brand-search input contract:

```json
{
  "inputs": [{
    "searchKeyword": "keyword",
    "searchLanguage": "<detected_language>",
    "channelType": "PublicUnauthenticated",
    "contentTypeFqn": "sfdc_cms__brand",