v1.1.0: patch brand-voice-enforcement SKILL.md — bash cat for settings read, Logo Usage section, Visual Identity quick reference block
This commit is contained in:
@@ -19,13 +19,72 @@ Apply Message Point Media's brand voice to all content creation. Load brand sett
|
||||
|
||||
Find MPM's brand settings using this sequence. Stop as soon as you find them:
|
||||
|
||||
1. **Plugin settings (always available)** — Read `settings/brand-voice.local.md` from the plugin directory. This file is baked into the plugin and contains the full MPM brand voice, messaging pillars, tone guidance, logo system, typography, color palette, and product terminology. This is the authoritative source.
|
||||
1. **Plugin settings (always available — REQUIRED first step)**
|
||||
|
||||
2. **Working folder override** — Check for `.claude/brand-voice.local.md` inside the user's working folder. If found, this project-specific version takes precedence over the plugin's baked-in settings. Merge any project-specific overrides with the plugin settings.
|
||||
Read `settings/brand-voice.local.md` from the plugin directory.
|
||||
|
||||
> ⚠️ **CRITICAL — READ METHOD:** The `Read` tool **cannot** access `.remote-plugins` paths and will fail silently, returning nothing. You **must** use `bash` with a `cat` command to read this file.
|
||||
>
|
||||
> Use the exact bash path — translate the plugin directory location to its bash mount path. For example, if the plugin is at:
|
||||
> `/Users/<user>/Library/Application Support/Claude/local-agent-mode-sessions/…/rpm/plugin_01HEVtHYefvdyxRVARpJsdRj/settings/brand-voice.local.md`
|
||||
>
|
||||
> …run it as:
|
||||
> ```bash
|
||||
> cat "/sessions/<session-id>/mnt/.remote-plugins/plugin_01HEVtHYefvdyxRVARpJsdRj/settings/brand-voice.local.md"
|
||||
> ```
|
||||
>
|
||||
> **If you cannot read the file:** STOP. Do not proceed with content generation. Tell the user: "I cannot access the brand voice settings file. Please verify the plugin is installed and the session has access to `.remote-plugins`."
|
||||
>
|
||||
> **Never silently fall back to generic colors, fonts, or a generic voice.** A failed read must surface as an explicit error — not invisible substitution.
|
||||
|
||||
This file contains the full MPM brand voice: messaging pillars, tone guidance, logo system, typography, color palette, and product terminology. It is the authoritative source.
|
||||
|
||||
2. **Working folder override** — Check for `.claude/brand-voice.local.md` inside the user's working folder. If found, this project-specific version takes precedence. Merge any project-specific overrides with the plugin settings.
|
||||
|
||||
3. **Session context** — Check if updated guidelines were generated earlier in this session via `guideline-generation`. If so, use those as the freshest source.
|
||||
|
||||
Also check for `.claude/brand-voice-guidelines.md` in the working folder — this is a generated output file from past guideline generation runs that may contain additional detail.
|
||||
Also check for `.claude/brand-voice-guidelines.md` in the working folder — this may contain additional detail from prior guideline generation runs.
|
||||
|
||||
## Logo Usage
|
||||
|
||||
When producing any document, presentation, proposal, or visual content, **always include the appropriate MPM logo.** Logo files are stored in the MPM Logos folder on Google Drive:
|
||||
|
||||
> **Google Drive — MPM Logos (authoritative):**
|
||||
> `drive.google.com/drive/folders/1xpO_sh0dQvWiMQbdmbhRZARuev4RpZiL`
|
||||
> - `01 New Logos > PNG` — Use for documents, presentations, web
|
||||
> - `01 New Logos > SVG` — Use for print and large-format
|
||||
|
||||
### Logo Selection Rules
|
||||
|
||||
| Background | Logo to Use | File |
|
||||
|---|---|---|
|
||||
| White or light backgrounds | **Standard Dark (DEFAULT)** | `Logo Standard-Dark.png` |
|
||||
| Dark, charcoal, or dark-gold backgrounds | **Gold + White text** | `Logo-Gold-White.png` |
|
||||
| Cover pages, title blocks with dark header bar | **Gold + White text** | `Logo-Gold-White.png` |
|
||||
| Single-color black print | **Black text only** | `Logo-Black-Text.png` |
|
||||
| Dark background, icon only needed | **White Cutout** | `Logo-White-Cutout.png` |
|
||||
|
||||
### Transit-Specific Content (proposals, specs, sell sheets)
|
||||
|
||||
For Community Transit or any transit agency deliverable, use the **TransitPoint sub-brand lockup**:
|
||||
- Light background: `MPM-Transitpoint-Dark.png`
|
||||
- Dark background: `MPM-Transitpoint-Light.png`
|
||||
|
||||
These are available in the same MPM Logos folder under the TransitPoint subfolder.
|
||||
|
||||
### Placement in Documents
|
||||
|
||||
- **DOCX / Word:** Top of title/cover page. Header of formal proposals (right-aligned or left-aligned per template).
|
||||
- **PPTX / Slides:** Top-right or top-left of title slide. Bottom-right of content slides as a watermark/identifier.
|
||||
- **PDFs:** Cover page and header/footer.
|
||||
- **Emails / HTML:** Above the signature block or in the email header.
|
||||
|
||||
### When Logo Files Are Not Accessible
|
||||
|
||||
If the Google Drive logos folder is not accessible in the current session:
|
||||
1. Explicitly tell the user: "I was unable to fetch the logo files from Google Drive. Please insert the appropriate logo manually — for a light-background document, use `Logo Standard-Dark.png` from the MPM Logos folder."
|
||||
2. Reserve a clearly labeled placeholder in the document: `[INSERT MPM LOGO HERE — Logo Standard-Dark.png]`
|
||||
3. Do **not** omit the logo silently or substitute a text-only reference without noting it.
|
||||
|
||||
## MPM Brand Identity Quick Reference
|
||||
|
||||
@@ -37,6 +96,29 @@ Before generating content, internalize these MPM-specific constants from the set
|
||||
- Primary: "Compelling… Affordable… Dynamic… Messaging… It's What We Do!"
|
||||
- Aspirational: "Born to Innovate. Built to Last." (brand-forward and thought leadership contexts)
|
||||
|
||||
**Visual Identity — Non-Negotiable (apply to all documents and presentations):**
|
||||
|
||||
Typography:
|
||||
- Headings / titles: **Montserrat** (Bold for H1, SemiBold for H2/H3)
|
||||
- Body text: **Open Sans** (Regular, 11pt / 22 half-points in DOCX)
|
||||
- Do **not** substitute Arial, Calibri, or any system default font
|
||||
|
||||
Color palette (hex values — use exactly):
|
||||
|
||||
| Role | Name | Hex |
|
||||
|---|---|---|
|
||||
| Heading text, document titles | Dark Gold | `#998643` |
|
||||
| Accent lines, dividers, borders | Middle Gold | `#DCBB4F` |
|
||||
| Body text | Dark Shade | `#232022` |
|
||||
| Page/section backgrounds (light) | Light Shade | `#F5F1EC` |
|
||||
| Subtle / secondary elements | Light Accent | `#849698` |
|
||||
| Table headers (background) | Dark Shade | `#232022` |
|
||||
| Table header text | Light Shade | `#F5F1EC` |
|
||||
| Alternating table rows | Warm Off-White | `#FAF7F2` |
|
||||
| Light gold (on dark backgrounds) | Light Gold | `#F5CD15` |
|
||||
|
||||
> ⚠️ **Do not use generic blues (#1A4F8A or similar), Calibri, or Arial in any MPM-branded output.** These are the single most common brand voice failures. If you catch yourself using a blue accent or a system font, stop and correct before delivering the output.
|
||||
|
||||
**We Are / We Are Not** (from settings):
|
||||
- Knowledgeable Partner, NOT Vendor
|
||||
- Innovative, NOT Hype-Driven
|
||||
|
||||
Reference in New Issue
Block a user