Guideline Generation

From the author

This skill generates, creates, or builds brand voice guidelines from source materials. It should be used when the user asks to "generate brand guidelines", "create a style guide", "extract brand voice", "create guidelines from calls", "consolidate brand materials", "analyze my sales calls for brand voice", "build a brand playbook from documents", "synthesize a voice and tone guide", or uploads brand documents, transcripts, or meeting recordings for brand analysis. Also triggers when the user has a discovery report and wants to convert it into actionable guidelines.

— the description by Tribe AI

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Guideline Generation transforms fragmented brand assets—such as documents, sales transcripts, and discovery reports—into a unified, LLM-ready brand playbook. It systematically extracts voice attributes, messaging pillars, and tone-by-context matrices while assigning confidence scores to ensure transparency. The skill produces a structured markdown document that serves as a single source of truth for brand identity, complete with 'We Are/We Are Not' anchors and actionable recommendations for team alignment.

What it does

Analyzes documents and transcripts to extract consistent brand voice attributes.
Creates a structured 'We Are / We Are Not' identity table with supporting evidence.
Builds a tone-by-context matrix to guide communication across different channels.
Assigns confidence scores to each section based on source corroboration.
Identifies ambiguities and generates actionable questions for team resolution.
Archives previous versions and saves the final guidelines to a project-specific path.

When to use it

When you need to formalize a brand voice from scattered documents and meeting notes.
After conducting a brand discovery process to convert findings into a usable playbook.
When you want to ensure consistent messaging across sales, marketing, and support teams.
When you need to resolve conflicts between different brand materials or communication styles.

Advantages

Reduces ambiguity by providing clear, evidence-based brand guidelines.
Ensures consistency by distinguishing between fixed voice constants and flexible tone.
Provides transparency through confidence scoring for every guideline section.
Facilitates team alignment by highlighting open questions that require human decision-making.
Integrates directly with other agent tools for immediate enforcement of the generated voice.

Usage examples

“Generate brand guidelines from my uploaded sales transcripts and company mission statement.”: The agent analyzes the provided files, identifies recurring language patterns and core values, and outputs a structured brand playbook with a tone matrix and voice attributes.
“I have a discovery report from our recent branding workshop. Can you turn this into actionable guidelines?”: The agent processes the discovery report as the primary source, synthesizes the findings into the standard template, and flags any areas requiring further team confirmation.

Install

Download the skill as a ZIP:
https://autogineer.com/agent-skills/anthropics/guideline-generation/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip guideline-generation.zip -d .agents/skills

Documentation by Tribe AI

Generate comprehensive, LLM-ready brand voice guidelines from any combination of sources — brand documents, sales call transcripts, discovery reports, or direct user input. Transform raw materials into structured, enforceable guidelines with confidence scoring and open questions.

Inputs

Accept any combination of:

Discovery report from the discover-brand skill (structured, pre-triaged)
Brand documents uploaded or from connected platforms (PDF, PPTX, DOCX, MD, TXT)
Conversation transcripts from Gong, Granola, manual uploads, or Notion meeting notes
Direct user input about their brand voice and values

When a discovery report is provided, use it as the primary input — sources are already triaged and ranked. Supplement with additional analysis as needed.

Generation Workflow

1. Identify and Classify Sources

Determine what the user has provided. If no sources are available:

Check if a discovery report exists from a previous /brand-voice:discover-brand run
Check .claude/brand-voice.local.md for known brand material locations
Suggest running discovery first: /brand-voice:discover-brand

2. Process Sources

For documents: Delegate to the document-analysis agent for heavy parsing. Extract voice attributes, messaging themes, terminology, tone guidance, and examples.

For transcripts: Delegate to the conversation-analysis agent for pattern recognition. Extract implicit voice attributes, successful language patterns, tone by context, and anti-patterns.

For discovery reports: Extract pre-triaged sources, conflicts, and gaps. Use the ranked sources directly.

3. Synthesize Into Guidelines

Merge all findings into a unified guideline document following the template in references/guideline-template.md. Key sections:

"We Are / We Are Not" Table — The core brand identity anchor:

We Are	We Are Not
[Attribute — e.g., "Confident"]	[Counter — e.g., "Arrogant"]
[Attribute — e.g., "Approachable"]	[Counter — e.g., "Casual or sloppy"]

Derive attributes from the most consistent patterns across sources. Each row should have supporting evidence.

Voice Constants vs. Tone Flexes — Clarify what stays fixed and what adapts:

Voice = personality, values, "We Are / We Are Not" — constant across all content
Tone = formality, energy, technical depth — flexes by context

Tone-by-Context Matrix:

Context	Formality	Energy	Technical Depth	Example
Cold outreach	Medium	High	Low	"[example phrase]"
Enterprise proposal	High	Medium	High	"[example phrase]"
Social media	Low	High	Low	"[example phrase]"

4. Assign Confidence Scores

Score each section using the methodology in references/confidence-scoring.md:

High confidence: 3+ corroborating sources, explicit guidance found
Medium confidence: 1-2 sources, or inferred from patterns
Low confidence: Single source, inferred, or conflicting data

5. Surface Open Questions

Generate open questions for any ambiguity that cannot be resolved:

## Open Questions for Team Discussion

### High Priority (blocks guideline completion)
1. **[Question Title]**
   - What was found: [conflicting or incomplete info]
   - Agent recommendation: [suggested resolution with reasoning]
   - Need from you: [specific decision or confirmation needed]

Every open question MUST include an agent recommendation. Turn ambiguity into "confirm or override" — never a dead end.

6. Quality Check

Before presenting, verify via the quality-assurance agent (defined in agents/quality-assurance.md):

All major sections populated (including Brand Personality and Content Examples if sources support them)
At least 3 voice attributes with evidence
"We Are / We Are Not" table has 4+ rows
Tone matrix covers at least 3 contexts
Confidence scores assigned per section
Source attribution for all extracted elements
No PII exposed
Open questions include recommendations

7. Present and Offer Next Steps

Summarize key findings:

Total sections generated with confidence breakdown
Strongest voice attribute and most effective message
Number of open questions (if any)

8. Save for Future Sessions

The default save location is .claude/brand-voice-guidelines.md inside the user's working folder.

Important: The agent's working directory may not be the user's project root (especially in Cowork, where plugins run from a plugin cache directory). Always resolve the path relative to the user's working folder, not the current working directory. If no working folder is set, skip the file save and tell the user guidelines will only be available in this conversation.

Resolve the save path. The file MUST be saved to .claude/brand-voice-guidelines.md inside the user's working folder. Confirm the working folder path before writing.
Check if guidelines already exist at that path
If they exist, archive the previous version: Rename the existing file to brand-voice-guidelines-YYYY-MM-DD.md in the same directory (using today's date)
Save new guidelines to .claude/brand-voice-guidelines.md inside the working folder
Confirm to the user with the full absolute path: "Guidelines saved to <full-path>. /brand-voice:enforce-voice will find them automatically in future sessions."

The guidelines are also present in this conversation, so /brand-voice:enforce-voice can use them immediately without loading from file.

After saving, offer:

Walk through the guidelines section by section
Start creating content with /brand-voice:enforce-voice
Resolve open questions

Privacy and Security

Enforce these privacy constraints throughout the entire generation workflow, not only at output time:

Redact customer names and contact information from all examples
Anonymize company names in transcript excerpts if requested
Flag any sensitive information detected during processing

Reference Files

references/guideline-template.md — Complete output template with all sections, field definitions, and formatting guidance
references/confidence-scoring.md — Confidence scoring methodology, thresholds, and examples

Files

ATTRIBUTION.mdAdded by AutoGineer1.1 KiB
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md6.9 KiB
references/confidence-scoring.md4.9 KiB
references/guideline-template.md7.0 KiB

SKILL.md