microcopy

Generates and refines UI microcopy in Chinese and English following LobeHub brand guidelines.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/SmallAi-API/smaihub --skill microcopy-smallai-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: microcopy
Source: https://github.com/SmallAi-API/smaihub/tree/main/.agents/skills/microcopy
Command: npx skills add https://github.com/SmallAi-API/smaihub --skill microcopy-smallai-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing consistent, on-brand UI copy across buttons, errors, empty states, and onboarding flows is hard, especially when maintaining bilingual Chinese-English parity and fixed product terminology. This Skill provides structured guidelines, terminology tables, and tone rules so every piece of user-facing text stays clear, actionable, and consistent. ## Core Features & Use Cases - Fixed Terminology Enforcement: Maps Chinese terms to exact English equivalents (e.g., 助理 → Agent, 上下文 → Context) so one concept always uses one term site-wide. - Bilingual Copy Guidelines: Language-specific references (references/zh.md and references/en.md) cover tone ratios, warmth caps, error message structure, and anti-patterns for both languages. - CN-to-EN i18n Translation: Translates raw Chinese i18n strings into natural, length-aware English while preserving placeholders like {name} or %s. - Use Case: When writing an error toast for a failed integration connection, the Skill enforces the required structure—what happened, optional why, and next action (Retry / View details / Go to Settings)—without blaming the user. ## Quick Start Ask the assistant to rewrite or translate a piece of UI copy, such as an empty-state message or error toast, following the microcopy guidelines.

Frequently Asked Questions about microcopy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write consistent UI error messages for my product?

Follow the required error structure: state what happened, optionally why, and what the user can do next. Always offer actionable options like Retry, View details, Go to Settings, or Contact support, and never blame the user or show only an error code.

How to translate Chinese i18n strings into natural English UI copy?

Provide the raw Chinese string and the Skill produces localized, product-native English rather than literal translation. It keeps visual length similar to the source, preserves placeholders like {name} or %s exactly, and prioritizes verb-plus-object phrasing for tight spaces like buttons and toasts.

What terminology should I use for agent product interfaces?

Use the fixed terminology table: Workspace, Agent, Group, Context, Memory, Integration, Skill, Agent Profile, Topic, Page, Community, Resource, Library, and Provider. One concept maps to exactly one term across the entire product, with no synonym mixing.

How much warmth should UI copy include without sounding sentimental?

Default to roughly 80 percent information and 20 percent warmth, rising to 70/30 only at key moments like first-time creation, empty states, failures, and long waits. Warmth is capped at half a sentence to one sentence and must be followed by a clear next action.

When should I avoid using this microcopy skill?

It is designed for user-facing product copy such as buttons, toasts, modals, and onboarding, not for long-form marketing content, documentation, or legal text. Serious scenarios like billing, security, and data loss prioritize neutral clarity over warmth.