skills.rest
Insik-Han
Insik-HanCOMMUNITY
Explore all skills by this author →
𝕏@insik0_0hanGitHub

enhanced-message-context

Annotate Lingui messages with translator comments using a YAML frontmatter contract and Markdown guide.

16|Updated Jun 6, 2026
Search Tags:#localization#i18n#ui-context#lingui#translator-comments#comment-best-practices
One-click install
npx skills add https://github.com/Insik-Han/han-monorepo-template --skill enhanced-message-context
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: enhanced-message-context
Source: https://github.com/Insik-Han/han-monorepo-template/tree/main/.agents/skills/enhanced-message-context
Command: npx skills add https://github.com/Insik-Han/han-monorepo-template --skill enhanced-message-context

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Lingui translations often lack UI context, causing ambiguous translations. This Skill provides a structured approach to annotate messages with translator comments to improve clarity and accuracy across the UI.

Core Features & Use Cases

  • Best-practice guidelines for when to add translator comments to Lingui messages.
  • Clear structure for location, purpose, and disambiguation in comments.
  • Examples of applying comments in JavaScript/React components to guide translators.

Quick Start

Add a descriptive translator comment to Lingui messages by including location and purpose, then verify translations in the TMS.

Frequently Asked Questions about enhanced-message-context

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

FAQPage Schema
How do I add translator comments to Lingui messages in React?▼

Add translator comments directly within your JavaScript and React components using a defined structure for location, purpose, and disambiguation to provide UI context and guide translators effectively.

Why do my Lingui translations lack UI context and have ambiguous terms?▼

Lingui translations lack UI context when messages are extracted without descriptive annotations. Adding structured translator comments clarifies the location, purpose, and term disambiguation to improve translation accuracy across the interface.

What is the best practice for writing translator comments for i18n strings?▼

Best practice for translator comments involves providing the specific UI location, the purpose of the string, and disambiguation for terms. This structured approach ensures contextual accuracy when implementing i18n in React projects.

When do I need to disambiguate terms in Lingui translator comments?▼

Disambiguate terms in Lingui translator comments when a UI string is ambiguous or lacks clear context. Provide specific location and purpose details to ensure translators understand the exact meaning across different UI contexts.

Does this approach to translator comments work with JavaScript projects outside of React?▼

Yes, while applicable for implementing i18n in React projects, the structured Markdown guide and YAML frontmatter contract for adding translator comments can also be applied to general JavaScript projects using Lingui.

How do I verify if my translator comments improve Lingui translation quality?▼

Verify translation quality by checking the updated messages in your TMS after adding descriptive comments. Ensure the location, purpose, and disambiguation details accurately reflect the UI context to guide translators.

Related Skills

Explore More Software Engineering Skills→
HorusGoulHorusGoul
8

enhanced-message-context

Add contextual comments to Lingui internationalization messages for translators.

Community
Intermediate
anicca-labsanicca-labs

i18n

Extract, translate, and compile Lingui strings for software applications.

Official
Intermediate
StaysrStaysr

i18n

Generate React localization translations from flat dot-notation keys with react-i18next.

Community
Intermediate
simotasimota
68

Polyglot

Extract hardcoded strings into translatable keys and integrate Intl API formatting.

Community
Advanced