Brief Best Practices skill
The Brief Best Practices skill is an organization skill from the Skills Directory in Mark (Optimizely Agent Platform). It defines your ideal brief structure, covering target audience, goals, related links, and financial impact. Mark applies it to every campaign and content brief to ensure consistency and the right inputs.
The skill applies to everyone in your organization when you choose Organization during configuration. Creating an organization skill requires the Manage Skills permission.
Skill details
The following details apply to this skill:
- Shortcut – /brief-best-practices
- Type – Organization skill
What the skill does
The skill does the following:
- Gives every campaign, content, event, launch, and creative brief the same 16-section structure.
- Writes goals as a verb, metric, target, deadline, and segment, with a baseline and a guardrail.
- Shows financial impact as one-line funnel math labeled Estimate, Committed, or Actual, with a range.
- Reviews briefs by grading each section Complete, Thin, or Missing and suggesting three fixes with rewrites. Never invents a number, name, or link.
Before you begin
Confirm the following before you install the skill:
- You must have the Manage Skills permission to install this skill. If you do not, click Request in the Skills Directory to ask an administrator to install it.
- Have your answers and files ready. Mark asks for them during configuration.
Information Mark asks for
Mark asks for the following during configuration. Skip optional items if you do not need them.
- What You Do and Which Briefs Your Team Writes – Your scope and brief types.
- How You Measure Goals and Financial Impact – Metric names, currency, deal value, stage rates, and sales cycle length. Stage rates are the share of deals that move to the next stage. Also provide the spend threshold that turns on cost rules. Without stage rates and sales cycle, impact is marked "Not yet sized".
- (Optional) Your Brief Template or a Brief You Were Proud Of – Mark copies the structure and level of detail. It never copies the content or numbers.
- (Optional) Audiences and Segments You Target – Your standard audiences.
- (Optional) Where Related Work Lives – Links to plans, budgets, assets, and past results. Missing links are marked "Link needed".
- (Optional) Anything Specific to Your Team – House rules. Defaults are one accountable owner and one to two pages.
Install the skill
Go to Directory > Skills, find Brief Best Practices, and click Install. In the Setup required dialog, click Set up in chat. Mark asks who the skill is for, Myself (Personal) or Organization. Mark then asks whether to answer the remaining questions in chat or upload a document. For the full procedure, see Install a skill that needs configuration.
Use the skill
After configuration, enter /brief-best-practices in Mark chat to run the skill on demand. Mark also applies it automatically when your request matches its When to use conditions. Try prompts like the following:
- Write a webinar brief for our Q3 launch.
- Review this campaign brief and tell me whether it is ready.
- Complete this brief from the CRM record.
Things to know
Keep the following in mind:
- Mark does not write a brief until it knows what the work is, who it is for, and the primary goal.
- Deal values and stage rates go stale. Review them regularly and edit the skill when they change.
Update the skill
When Optimizely publishes an updated version, Update displays on the skill's card in the Skills Directory. Mark keeps the information you provided during configuration and asks only for anything the updated version adds. To correct answers that are no longer accurate, edit the installed skill. See Update a skill and Manage skills.
Note
If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.