# Locale Extractor

> Tools to extract hardcoded text from Liquid files and replace them with translation keys.

- Skill: `majiayu000/locale-extractor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/locale-extractor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/locale-extractor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/locale-extractor

---


## 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**:

```liquid
<h1>Hello World</h1>
<p>Welcome to our store</p>
```

**Output**:

```json
{
  "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"
      }
    }
  }
}
```