Kai Brief logo

Kai Brief

Community
cgallic
kai-brief

Create a structured content brief using the marketing harness brief schema. Selects persona, defines angle, sets quality targets. Use when "create a brief", "content brief", "plan this content", "brief for [topic]", "what persona should I use", or before any content creation to define the strategy. Outputs a brief that /kai-write and /kai-email-system consume.

Overview

Publishercgallic
Repositorykai-cmo-harness
Skill namekai-brief
Stars
61
Forks
8
Bundled files
Instructions only
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by cgallic on GitHub. Read the source before you install it.

Installation

Install the Kai Brief AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/cgallic/kai-cmo-harness/tree/main/harness/skills-v2/kai-brief
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/cgallic/kai-cmo-harness.git /tmp/kai-cmo-harness
mkdir -p .claude/skills
cp -r /tmp/kai-cmo-harness/harness/skills-v2/kai-brief .claude/skills/kai-brief
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Kai Brief in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Kai Brief on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Kai Brief is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

/kai-brief — A Brief /kai-write Can Execute Without Asking Anything

Objective

A structured content brief that fixes the strategy before drafting starts: format, keyword set, persona, the specific angle, three hook options, the audience pain, the proof on hand, the CTA, word count, and publish date. It is the handoff contract /kai-write and /kai-email-system consume. The angle is the load-bearing field — "AI for law firms" is a topic; "Why law firms lose 40% of leads after 5pm" is an angle.

Done when

Work type strategy-plan — floor E3/C3/O1 (harness/eco-floors.yaml).

  • E3 — the brief conforms to harness/brief-schema.md and the requester accepted it; /kai-write does not proceed on an unapproved brief.
  • C3 — banned_word_check clean, and the three validation rules below hold under a read by someone other than the brief's author.
  • O1 — the brief names the piece it spawns and its publish date. A brief nothing gets written from is not finished.

Constraints

  • Read MARKETING.md from the project root first. It carries product, ICP, value prop, monetization, voice, current channels, and competitive landscape. If it does not exist, build it from the codebase — CLAUDE.md, README.md, PROJECT.md, package.json, landing pages, email/ad/analytics config — using the template from /kai-email-system, and confirm the draft. Do not ask the user what the product is.
  • Six things must be known before the brief is written: the format (blog, email, LinkedIn, ad, press), the topic or keyword, who it is for, the angle, what the reader should do next, and what proof or data exists to use.
  • Load the full persona file, not just the one-line hook — it carries the language patterns, pain points, and hooks that shape the angle. The brief then follows the schema in harness/brief-schema.md, which is the format contract: fields are neither invented nor dropped.
  • Three rules must hold before handoff: hook_options has exactly 3 variants; angle is differentiated from target_keyword rather than restating it; proof_available names real data or a named example, never a vague gesture at proof.

Context

NeedLoad
Brief field schema and format contractharness/brief-schema.md
Full persona profiles, language, pain pointsknowledge/personas/_persona-index.md
Product, ICP, voice, channelsMARKETING.md (project root)

Persona selection — pick one from the set below, then load its full file:

PersonaCore hookBest for
Competent Cog"The system treats you like a child"B2B SaaS, enterprise
Shock Absorber"Accountability without authority"Middle management
Ghosted Applicant"The game is rigged"Job seekers, HR tech
Subscription Serf"They bet you won't fight back"Consumer SaaS
System Manager"No village, only vendors"Parents, household managers
Admin Martyr"Death by a thousand tasks"Admin and ops roles
Obsolescence Anxious"Working hard isn't the variable"Career-concerned professionals
Credibility Fighter"You're not crazy"Experts fighting misinformation

Escalate when

  • No proof, data, or named example exists for the angle — a brief promising specificity the writer cannot deliver moves the failure downstream.
  • The requested topic maps to no persona in the set, or the angle needs a claim the business cannot substantiate.
  • Format and word count conflict with the skill contract for that format.

Frequently asked questions

What does the Kai Brief AI skill do?

Create a structured content brief using the marketing harness brief schema. Selects persona, defines angle, sets quality targets. Use when "create a brief", "content brief", "plan this content", "brief for [topic]", "what persona should I use", or before any content creation to define the strategy. Outputs a brief that /kai-write and /kai-email-system consume.

Why use Kai Brief on TypingMind?

Because you install it once and use it with any model. Kai Brief is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Kai Brief in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/cgallic/kai-cmo-harness/tree/main/harness/skills-v2/kai-brief. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Kai Brief?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Kai Brief?

As many as you like. As long as a model supports skills, you can use Kai Brief with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Kai Brief AI skill free?

It is published on GitHub by cgallic. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇