SKILL.md
LobeHub UI Microcopy Guidelines
This file is the quick-reference summary. For full prompt-style guidelines with extensive examples (anti-patterns, tone matrices, scenario walk-throughs), load the language-specific reference:
- 中文文案 — references/zh.md
- English copy — references/en.md
Brand: Where Agents Collaborate - Focus on collaborative agent system, not just "generation".
Fixed Terminology
Chinese
English
空间
Workspace
助理
Agent
群组
Group
上下文
Context
记忆
Memory
连接器
Integration
技能
Skill
助理档案
Agent Profile
话题
Topic
文稿
Page
社区
Community
资源
Resource
库
Library
模型服务商
Provider
评测
Evaluation
基准
Benchmark
数据集
Dataset
用例
Test Case
Brand Principles
- Create: One sentence → usable Agent; clear next step
- Collaborate: Multi-agent; shared Context; controlled
- Evolve: Remember with consent; explainable; replayable
Writing Rules
- Clarity first: Short sentences, strong verbs, minimal adjectives
- Layered: Main line (simple) + optional detail (precise)
- Consistent verbs: Create / Connect / Run / Pause / Retry / View details
- Actionable: Every message tells next step; avoid generic "OK/Cancel"
Human Warmth (Balanced)
Default: 80% information, 20% warmth
Key moments: 70/30 (first-time, empty state, failures, long waits)
Hard cap: At most half sentence of warmth, followed by clear next step.
Order:
- Acknowledge situation (no judgment)
- Restore control (pause/replay/edit/undo/clear Memory)
- Provide next action
Avoid: Preachy encouragement, grand narratives, over-anthropomorphizing
Patterns
Getting started:
- "Starting with one sentence is enough. Describe your goal."
- "Not sure where to begin? Tell me the outcome."
Long wait:
- "Running… You can switch tasks—I'll notify you when done."
- "This may take a few minutes. To speed up: reduce Context / switch model."
Failure:
- "That didn't run through. Retry, or view details to fix."
- "Connection failed. Re-authorize in Settings, or try again later."
Collaboration:
- "Align everyone to the same Context."
- "Different opinions are fine. Write the goal first."
Errors/Exceptions
Must include:
- What happened
- (Optional) Why
- What user can do next
Provide: Retry / View details / Go to Settings / Contact support / Copy logs
Never blame user. Put error codes in "Details".