locale-extractor

---

name: Locale Extractor version: 1.0.0 description: Tools to extract hardcoded text from Liquid files and replace them with translation keys. allowed-tools:

• extract_locales

---

Capabilities

Helps developers internationalize their themes by finding hardcoded strings and moving them to a locale JSON structure.

Tools Usage Guide

1. extract_locales

Scans Liquid content for hardcoded text inside HTML tags and proposes replacements.

• Param liquid_content: The raw liquid code.
• Param section_name: The name of the section (used for key namespacing).
• Returns:
  • modified_liquid: The code with {{ 'key' | t }} replacements.
  • new_locales: A JSON object with the extracted keys and values.

Example

Input:

Copy<h1>Hello World</h1>
<p>Welcome to our store</p>

Output:

Copy{
  "modified_liquid": "<h1>{{ 'sections.header.hello_world' | t }}</h1>\n<p>{{ 'sections.header.welcome' | t }}</p>",
  "new_locales": {
    "sections": {
      "header": {
        "hello_world": "Hello World",
        "welcome": "Welcome to our store"
      }
    }
  }
}