translation-discipline

Replace internal codes and jargon with plain language in user-facing messages.

2|Updated May 3, 2026
One-click install
npx skills add https://github.com/lukeivers/loam --skill translation-discipline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translation-discipline
Source: https://github.com/lukeivers/loam/tree/main/plugins/loam-skills/skills/translation-discipline
Command: npx skills add https://github.com/lukeivers/loam --skill translation-discipline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes internal artefact references and jargon from user-facing responses, ensuring clear and user-friendly communication.

Core Features & Use Cases

  • Artifact Leakage Prevention: Checks and replaces commit SHAs, AC IDs, and internal pointers with understandable descriptions.
  • Language Refinement: Translates internal abbreviations and references into plain language suitable for end-users.
  • Use Case: When preparing a customer report, it ensures internal codes like "F3" or "AC.PSAFE.3" are explained in an accessible manner, maintaining professionalism and clarity.

Quick Start

Apply the translation-discipline checklist to draft responses, replacing internal jargon and references with clear, user-centered language.

Frequently Asked Questions about translation-discipline

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

FAQPage Schema
How do I remove internal jargon from user-facing AI communication?

To remove internal jargon from user-facing AI communication, apply a translation checklist that replaces commit SHAs, internal IDs, and technical paths with plain language descriptions, improving message clarity and professionalism.

What's the best way to prevent technical artefact references from leaking into customer reports?

Preventing technical artefact references from leaking into customer reports involves translating internal codes and abbreviations into accessible language, ensuring technical details are explained clearly without exposing internal system markers.

Why does my AI assistant include internal codes in status updates?

Your AI assistant includes internal codes in status updates because it lacks a translation discipline to filter technical artefacts, requiring a specific rule set to replace internal pointers with understandable descriptions for end users.

Can I translate internal abbreviations into plain language for end users automatically?

You can translate internal abbreviations into plain language for end users by applying a dedicated translation discipline checklist that identifies and replaces internal references with user-centered language during message drafting.

Does this translation discipline work for all user-facing messages?

This translation discipline works for user-facing messages where AI communicates results, status updates, or explanations, ensuring responses avoid internal codes, abbreviations, and technical paths unless explicitly requested by the user.

When should I not use a jargon translation approach for AI communication?

You should not use a jargon translation approach when users explicitly request internal codes, commit SHAs, or technical paths, as this discipline is designed to replace those exact internal references with plain language descriptions.