skills/hq-brand-review/SKILL.md
Use when reviewing content for Sharkitect Digital brand voice compliance, detecting brand drift across communications, checking for banned terms or tone violations, or conducting a structured brand assessment using the 6-step protocol. Covers all content types: emails, proposals, landing pages, social posts, presentations, and AI-generated outputs. NEVER use for general copywriting feedback without brand focus (use copywriting skill), tone calibration for difficult conversations (use communication-excellence-coach agent), or visual design review (use ui-ux-designer agent).
npx skillsauth add sharkitect-solutions/sharkitect-claude-toolkit hq-brand-reviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| File | Load When | Do NOT Load |
|------|-----------|-------------|
| references/brand-guide.md | Every brand review (defines voice attributes, banned terms, tone targets, linguistic foundations) | Never skip -- this IS the standard |
| references/review-protocol.md | Every full 6-step review (defines scoring methodology, thresholds, edge cases) | Quick banned-term spot checks that skip the full protocol |
| IN SCOPE | OUT OF SCOPE | Use Instead |
|----------|-------------|-------------|
| Brand voice compliance scoring | General copywriting feedback | copywriting skill |
| Banned term detection | Rewriting flagged content | communication-excellence-coach agent |
| Tone consistency analysis | Visual/design brand compliance | ui-ux-designer agent |
| AI-generated content voice check | Content strategy planning | content-strategist agent |
| Brand drift quantification | Message framing for difficult conversations | communication-excellence-coach agent |
| Multi-document consistency audits | SEO keyword optimization | seo-optimizer skill |
| Channel-specific tone calibration | Social media post creation | social-content skill |
Launch brand-reviewer agent (Task tool, model: sonnet) for execution:
Support agents (launched alongside or after):
communication-excellence-coach — Tone refinement after brand review flags issuescontent-strategist — Voice/tone governance across content programsUse this skill directly (without agent) for:
CONTENT READY FOR REVIEW
|
+-- Is it client-facing (email, proposal, landing page, social)?
| YES --> Full brand review (launch brand-reviewer agent)
| NO --> Continue
|
+-- Is it generated by AI (Claude, GPT, or any LLM)?
| YES --> Full brand review (AI drift is the #1 source of brand erosion)
| NO --> Continue
|
+-- Is it internal documentation or technical spec?
| YES --> Skip brand review (internal docs don't need brand voice)
| NO --> Continue
|
+-- Is it going to 10+ recipients or a public channel?
| YES --> Full brand review
| NO --> Quick check (scan for banned terms, verify tone alignment)
The full brand guide is in the companion file. For quick checks, Sharkitect's voice is:
| Attribute | Target Range | Red Flag | |-----------|-------------|----------| | Confident | 7-9/10 | Hedge words ("maybe", "might", "possibly") | | Direct | 7-9/10 | Passive voice exceeding 15% of sentences | | Expert | 6-8/10 | Unexplained jargon OR oversimplification | | Approachable | 6-8/10 | Corporate stiffness OR forced casualness | | Action-Oriented | 7-9/10 | Vague conclusions, no clear next step |
After the brand-reviewer agent completes its 6-step protocol:
| Determination | Score | Action | |--------------|-------|--------| | Brand-Clear | 25-30 | Publish as-is. Optional minor notes. | | Aligned with Notes | 18-24 | Publish after listed changes. Max 3 specific fixes. | | Revision Required | 10-17 | Return to author with detailed change list. | | Escalation Required | 0-9 | Fundamental voice mismatch. Needs rewrite with brand guide. |
communication-excellence-coach or content-strategist -- separate the judge from the editor.references/review-protocol.md exists to make brand compliance measurable and repeatable. Always score. Always record the determination.references/brand-guide.md every time.Bilingual content (English + Spanish): Score each language section independently using the same protocol. Spanish business communication norms are slightly more formal -- allow +1 on formality target for Spanish sections. Check Spanish sections for direct translations of English banned terms (e.g., "sinergia", "de vanguardia", "al final del dia").
Heavily technical content (API docs, architecture specs, SOWs with technical appendices): Shift Expert target to 8-10 and relax Approachable to 4-6. Technical readers expect precision over warmth. Contextual bans on "AI-powered" and "scalable" are lifted when accompanied by specific metrics or architecture details. Default audience: Technical decision-maker.
Intentionally informal content (team celebrations, casual social, internal announcements): If the author explicitly flags "intentionally casual" or the channel is internal-only: relax all voice attribute targets by -2 points, skip contextual ban scan (absolute bans still apply), and adjust determination thresholds down by 5 points. Document the relaxation in the review report for traceability.
Multi-author content (proposals with sections from different writers): Score each section independently, then score overall consistency. Flag sections where any voice attribute differs by >3 points from the document average. Tone consistency is the highest-risk dimension here -- readers notice jarring shifts between sections even when individual sections are on-brand in isolation.
Content quoting external sources (testimonials, partner copy, regulatory text): Quoted material is exempt from brand review scoring. Mark quoted sections clearly in the review. Score only the Sharkitect-authored framing around the quotes. If quotes dominate (>50% of content), note that the piece's overall brand impression depends heavily on non-controlled text.
development
When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' or 'audience targeting.' This skill covers campaign strategy, ad creation, audience targeting, and optimization.
testing
--- name: using-sharkitect-methodology description: Use when starting any conversation in a Sharkitect workspace OR before any task involving NEW pricing, positioning, proposal, strategy, plan-execution, or schema-design work — mandates invocation of Sharkitect-specific methodology skills (pricing-strategy, marketing-strategy-pmm, smb-cfo, hq-revenue-ops, executing-plans, brainstorming) under the same anti-rationalization discipline as using-superpowers. Documentation has failed 4 times across H
testing
Use when user says 'end session', 'wrap up', 'stop for the day', 'done for today', 'close out', 'save session', 'wrapping up', or invokes /end-session. Runs the full 9-step end-of-session protocol: resource audit, MEMORY.md update, lessons capture, plan status, pending items, workspace checklist, .tmp/ audit, git commit+push, Supabase brain sync, session brief, summary. Final step schedules a detached self-kill of the current session ONLY (3s delay) so the window closes cleanly. Other claude.exe processes (active workspaces) are NOT touched -- orphan cleanup is handled separately by Claude-Orphan-Cleanup-Hourly with proper age safeguards. Do NOT use for: mid-session quick saves (use session-checkpoint), skill syncing (use sync-skills.py), brain memory queries (use supabase-sync.py pull), document freshness reviews (use document-lifecycle), resource gap detection (use resource-auditor).
testing
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, passive voice, negative parallelisms, and filler phrases.