diff --git a/skills/brand-glossary/references/glossary.md b/skills/brand-glossary/references/glossary.md deleted file mode 100644 index 4ac99dc..0000000 --- a/skills/brand-glossary/references/glossary.md +++ /dev/null @@ -1,109 +0,0 @@ -# Glossary: Brand Glossary - -## Overview - -One of the inputs for content generation skills is a brand glossary, produced by the Document Your Brand Glossary skill. This glossary explains how that document is structured: what each section contains, what values to expect, and how to interpret them. - -**Producing skill:** Document Your Brand Glossary -**Current version:** v0.1 -**Document type:** Brand glossary -**Purpose:** Defines approved terminology, forbidden terms, internal-to-customer mappings, and branded term styling rules for a brand. -**Consumers:** Any skill that generates customer-facing text (product descriptions, email copy, social captions, product tags, review responses, collection descriptions, landing pages). - -## Document Structure - -| Section | Description | -|---|---| -| Brand Name and Branded Terms | How the brand name and proprietary product/technology names must appear, including capitalization and spacing rules. | -| Approved Terminology | Tables of approved terms organized by category (e.g., Product Attributes, Materials, Sizing, Shipping). Categories vary by brand. | -| Terms to Avoid | Terms the brand does not use, with approved alternatives and reasoning. Hard constraints. | -| Internal-to-Customer Mapping | Translations from internal jargon, abbreviations, and warehouse/inventory terminology to customer-facing language. | -| Industry and Category Terms | How the brand handles standard terminology common to its product category. | -| Confidence Notes | Present only when the glossary was built from limited input. Flags gaps and thin coverage areas. | - -## Section Hierarchy - -When multiple sections provide guidance that applies to the same output: - -1. Terms to Avoid. Hard constraints. Never use an avoided term regardless of what other sections suggest. -2. Brand Name and Branded Terms. Exact styling rules. Override any other capitalization or formatting preference. -3. Approved Terminology. Specific term choices for specific contexts. -4. Internal-to-Customer Mapping. Apply when the source material uses internal language that needs translation. -5. Industry and Category Terms. Directional. Follow the brand's stated approach unless a more specific section overrides it. -6. Confidence Notes. Informational only. Do not treat flagged gaps as permission to invent terminology. - -## Handling Missing or Unexpected Input - -**A section has few entries or is sparse:** -The glossary may have been built from limited input. Use the terms that are present. For situations not covered, fall back to general ecommerce best practices and note to the user that the glossary didn't cover that term. - -**An expected section is missing entirely:** -Treat as uncovered. Fall back to best practices for that category of terminology. Do not invent glossary entries. - -**The version marker is older than the current glossary version:** -Check the changelog below. Apply current definitions but account for structural differences noted for that version. - -**The document was not generated by this skill:** -The user may have written their own terminology reference. Do not reject it. Map whatever structure is present to the sections described here. Apply Terms to Avoid as hard constraints if a similar section exists. Fall back to best practices where coverage is missing. - -## Field Definitions - -### Brand Name and Branded Terms - -Each entry is a table row with three columns. - -| Column | What it contains | How to apply | -|---|---|---| -| Term | The branded term as the brand uses it internally. | Match this to identify when the term appears in your task. | -| Approved Styling | The exact capitalization, spacing, and formatting to use. | Copy exactly. This is the definitive rendering of the term. | -| Usage Notes | Restrictions, context, or clarifications. | Follow any restrictions stated here. | - -### Approved Terminology - -Organized under category subheadings (e.g., "Product Attributes," "Materials and Construction"). Categories vary by brand. Each category contains a table with three columns. - -| Column | What it contains | How to apply | -|---|---|---| -| Approved Term | The term to use in customer-facing content. | Use this exact term when describing the relevant attribute, material, or concept. | -| Use When | The context or situation where this term applies. | Check that the context matches before applying. | -| Notes | Additional guidance, including formatting (hyphenation, capitalization). | Follow formatting rules exactly. | - -### Terms to Avoid - -A table with three columns. This is the highest-priority section. - -| Column | What it contains | How to apply | -|---|---|---| -| Avoid | The term that must not appear in output. | Scan all generated content for this term. If present, replace it. | -| Use Instead | The approved replacement, or an instruction to omit. | Substitute directly. If the instruction is "(omit)," remove the concept rather than replacing the word. | -| Reason | Why the term is avoided. | Informational. Helps you make judgment calls on similar terms not explicitly listed. | - -### Internal-to-Customer Mapping - -A table with three columns. - -| Column | What it contains | How to apply | -|---|---|---| -| Internal Term | The abbreviation, jargon, or internal label. | If this term appears in source data (product feeds, CSVs, internal briefs), translate it. | -| Customer-Facing Term | What the customer should see. | Use this in all generated output. | -| Context | Where and how to apply the translation. | Some translations are context-dependent (e.g., expand an abbreviation on first mention, use short form after). | - -### Industry and Category Terms - -A table with three columns. - -| Column | What it contains | How to apply | -|---|---|---| -| Industry Term | A standard term used across the brand's product category. | Recognize this term in source material and in the task context. | -| Brand's Approach | Whether the brand uses it directly, modifies it, or avoids it. | Follow the stated approach. | -| Notes | Additional context on why and how. | Informational. Helps with judgment calls on related terms. | - -### Confidence Notes - -A bulleted list present only when the glossary was built from limited input. Each bullet identifies a gap or area of thin coverage. - -**How to apply:** Do not treat gaps as permission to freelance. Where the glossary has thin coverage, use general ecommerce best practices and avoid making strong terminology choices the brand hasn't explicitly approved. - -## Changelog - -**v0.1** Initial release.