Build a reusable brand knowledge package from uploaded brand documents and/or a filled intake form. Use when the user wants a standardized brand SSOT contain...
---
name: brand-knowledge-base-builder
description: Build a reusable brand knowledge package from uploaded brand documents and/or a filled intake form. Use when the user wants a standardized brand SSOT containing company intro, products/services, target users, selling points, cases, FAQ, contact info, website links, competitors, banned words, and brand tone.
---
# Brand Knowledge Base Builder
## Purpose
Use this skill to turn scattered brand materials into a standardized, reusable brand package that can feed downstream content, sales, support, FAQ, RAG, or Agent workflows.
This skill is for building a **Single Source of Truth**, not for writing one-off marketing copy.
## What It Accepts
Use one or both of these input modes:
1. `Upload raw materials`
- 官网文案
- 公司介绍
- 产品资料
- 销售话术
- FAQ 草稿
- 客户案例
- 访谈或语音转文字
2. `Fill an intake form`
- Run the skill in template mode to generate `intake_form.md`, `intake_form.yaml`, or `intake_form.json`
- Let the user fill key fields first, then append raw materials if needed
## First-Use Requirement
On the **first turn this skill is used**, do not jump straight into extraction.
You must first clearly tell the user:
1. This skill builds a reusable brand SSOT, so the company needs to provide source materials first.
2. The company can provide materials in either of these ways:
- Upload raw materials directly
- Fill the intake form first, then optionally append raw materials
3. If the company does not provide enough information, the skill may still generate a draft, but missing fields must be marked as `待确认`, and the analysis report must list follow-up questions.
You must explicitly ask the user to provide the following **minimum required materials**:
- 公司基础信息:品牌名称、公司名称、所属行业、产品类别、一句话定义、100 到 300 字公司简介
- 官网与公开链接:官网首页、产品页、案例页、FAQ 页;如果没有完整官网,至少提供对外介绍页或文档
- 产品与服务说明:卖什么、解决什么问题、怎么交付、如何收费
- 目标客户信息:核心客户、次级客户、决策人、使用者、不适合客户
- 核心卖点:至少 3 条卖点,并尽量附证据、数据、客户反馈或资质依据
- 联系方式:销售邮箱、支持邮箱、电话、微信/社媒、地址、工作时间、预约方式
- 品牌语气与表达规范:语气关键词、必须出现的说法、禁用词、禁用承诺、安全替代表达
- 合规边界:哪些能说、哪些不能说、哪些效果不能承诺、哪些内容必须人工审核
You should then strongly recommend these **additional materials**:
- 客户案例 2 到 5 条:客户类型、原问题、解决方案、结果、证据
- FAQ 种子问题 10 到 20 条:价格、效果、安全、交付周期、合作方式
- 竞品与替代方案:直接竞品、间接竞品、传统做法、外包方案、行业 SaaS
- 销售或客服话术:开场白、异议处理、报价说明、边界说明
- 原始素材:官网文案、宣传册、访谈纪要、录音转文字、产品说明、案例文档
## Required Coverage
The final package should cover:
- 公司简介
- 产品与服务
- 目标客户
- 核心卖点
- 使用场景与客户案例
- FAQ
- 联系方式
- 官网链接
- 竞品与替代方案
- 品牌语气
- 禁用词与禁用承诺
- 合规边界
## Workflow
1. Intake
- On first use, explicitly tell the user what the company must provide
- Collect files and/or a filled intake template
- Prefer mixed mode when the user has partial structure plus raw docs
- If the user has not prepared enough material, direct them to the intake template instead of proceeding silently
2. Core extraction
- Produce a canonical JSON package
- Prioritize factual sections over derivative writing assets
3. Analysis
- Score completeness
- Identify missing fields, conflicts, assumptions, and follow-up questions
4. Asset generation
- Generate FAQ, glossary, standard messaging, and `llms.txt` inputs
5. Export
- Render the full package into:
- `brand_knowledge_base.json`
- `brand_knowledge_base.yaml`
- `brand_knowledge_base.md`
- `faq.md`
- `glossary.md`
- `standard_messaging.md`
- `llms.txt`
- `analysis_report.md`
## Safety Rules
- Do not invent missing facts.
- Use conservative wording.
- Strip or rewrite unverified absolute claims.
- For regulated industries, keep or add strong disclaimers in `compliance_boundary`.
- Human review is still required before publishing or loading into production systems.
- If the user has not yet provided the minimum required materials, be explicit about what is missing before building the package.
## Files To Read
- For intake guidance: `prompts/intake.md`
- For extraction rules: `prompts/extraction.md`
- For analysis rules: `prompts/normalization.md`
- For derivative assets: `prompts/asset_generation.md`
- For schema shape: `templates/brand_knowledge_base.json`
## Runtime Notes
- `main.py` is the executable entrypoint.
- `--generate_intake_template` creates fillable intake files.
- `--input` and `--inputs` accept raw material files.
- `--intake_file` accepts a structured intake form.
- `--render_from_json` re-renders the full artifact set from an existing package JSON.
## First Reply Pattern
When the skill is first invoked, the assistant should lead with a message equivalent to:
`使用本 Skill 前,请先按要求提供品牌资料。至少需要:公司简介、官网链接、产品服务、目标客户、核心卖点、联系方式、品牌语气与禁用词、合规边界。强烈建议同时提供客户案例、FAQ、竞品信息、销售话术和其他原始素材。你可以直接上传资料,或者先填写 intake 表单。若资料不完整,系统会生成初稿,并把缺失项标记为“待确认”。`
don't have the plugin yet? install it then click "run inline in claude" again.