name: brand-guidelines description: > Apply firm brand guidelines whenever creating, formatting, or styling any document, presentation, report, memo, or visual material for the firm. Use this skill before producing any Word document, PowerPoint, PDF, HTML artifact, or other output that carries the firm's name or represents the firm externally or internally. Trigger on requests like "create a doc," "write a memo," "make a deck," "draft a report," "build a template," "design a one-pager," or any time the user needs a branded deliverable. User preferences always take priority — if the user specifies colors, fonts, or layout that differ from this guide, follow their instructions and fall back to these guidelines for anything unspecified.
Brand Guidelines
Apply these guidelines as defaults for all firm documents and materials. User-specified preferences override any of these defaults. This file is a template — fill each section with the firm's actual values before activating.
Colors
Define the firm's palette here. Keep the list tight — a primary, a deep/secondary background tone, and a neutral body-text color is usually enough. Add accents only when they earn their place.
Primary Palette
| Name | Hex | Use |
|-------------|-----------|------------------------------------------|
| Primary | #______ | Primary backgrounds, headers, key UI |
| Secondary | #______ | Deep backgrounds, footers, dark sections |
| Body Text | #______ | Body copy on light backgrounds, borders |
Color Usage Rules
- State the default background (e.g., always white, or always dark) and when — if ever — the opposite is allowed.
- State which color is used for headings vs. body copy.
- State whether accent colors outside the palette are permitted.
Typography
Define the firm's typefaces. Distinguish between the digital/web font and the Office/print fallback. List exact weights — "Medium" and "Regular" are not the same as "Bold."
Primary Font (digital / HTML / web)
- Headlines:
<font name + weight> - Body:
<font name + weight> - Source/loader:
<Google Fonts URL or license note>
Secondary Font (Word, PowerPoint, system fallback)
- Headlines:
<font name + weight> - Body:
<font name + weight> - Use when the primary font is unavailable (e.g., .docx files on machines without the web font installed).
Type Hierarchy
| Level | Font | Weight | Notes |
|------------|------------|----------|------------------------|
| H1 / Cover | <font> | <wt> | Large, commanding |
| H2 | <font> | <wt> | Section headers |
| H3 | <font> | <wt> | Subsection labels |
| Body | <font> | <wt> | Standard paragraph |
| Caption | <font> | <wt> | Smaller, muted |
Logo
Document where logo assets live, what each variant is for, and what the rules are.
Asset Inventory
List every approved variant — full wordmark, abbreviated mark, monogram/initials — in both light-background and dark-background versions. Reference file paths inside the skill's assets/ folder so the agent can embed them directly.
| File path | Variant | When to use |
|-----------|---------|-------------|
| assets/<full-logo-light>.png | Full wordmark, for dark backgrounds | Cover pages, title slides on dark fills |
| assets/<full-logo-dark>.png | Full wordmark, for light backgrounds | Cover pages, title slides on white |
| assets/<mark-light>.png | Compact mark, for dark backgrounds | Headers, footers, watermarks on dark |
| assets/<mark-dark>.png | Compact mark, for light backgrounds | Headers, footers, watermarks on light |
Logo Usage Rules
- State which variant goes on which background.
- State default placement (e.g., top-left of cover pages, headers, title slides).
- Never stretch, recolor, crop, or recreate the logo.
- If asset files are unavailable for a given output format, leave a clearly labeled placeholder:
[FIRM LOGO — <expected file path>].
Document Formatting Defaults
Word Documents (.docx)
- Background:
<white | other> - Primary text color:
<hex> - Fonts:
<heading font + weight>for headings,<body font + weight>for body - Heading 1:
<pt size>,<font + weight>,<color hex> - Heading 2:
<pt size>,<font + weight>,<color hex> - Body:
<pt size>,<font + weight>,<color hex> - Accent lines / dividers:
<color hex> - Tables: header row fill
<color hex>with<text color>; other rows<color> - Margins:
<e.g., 1 inch> - Logo placement:
<e.g., top-left of header>; page numbers:<e.g., bottom-right of footer>
Presentations / Decks (.pptx)
- All slides:
<background color>,<text color> - Fonts:
<title font + weight>for titles,<body font + weight>for body - Accent color for dividers and emphasis:
<hex>
HTML / React Artifacts
- Load the primary font (e.g., Google Fonts import).
- Define brand colors as CSS variables:
--brand-primary: #______; --brand-secondary: #______; --brand-text: #______; - State background rule (e.g., white only).
PDFs
- Follow Word document defaults above.
- Cover page:
<background>,<text color>, logo<placement>.
Firm Name Usage
Approved names — use only these:
<Full legal / formal name>— use in official documents, external materials, and first references.<Acceptable shorthand>— use in body copy after the full name has been introduced.<Acceptable abbreviation>— use after the full name has been introduced.
Never use:
<List any forbidden abbreviations, truncations, or variants>.
When writing documents, introduce the firm by its full name on first reference, then use the approved shorthand or abbreviation for subsequent references as appropriate to the context.
Quick Checklist
Before delivering any firm document, verify:
- [ ] Colors come from the approved palette only (or match user-specified overrides).
- [ ] Background matches the default rule.
- [ ] Correct font for the output format (Office vs. digital).
- [ ] Logo asset embedded from
assets/folder, correct variant for the background. - [ ] Heading hierarchy consistent.
- [ ] Firm name uses only approved variants — no off-list abbreviations.