# Fgeistert Skills Add String Weblate

> Add Localized String

- Skill: `tomevault-io/fgeistert-skills-add-string-weblate` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/fgeistert-skills-add-string-weblate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/fgeistert-skills-add-string-weblate/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/fgeistert-skills-add-string-weblate

---


# Add Localized String

This skill adds one or more localized strings to your iOS app. It is designed to minimize
tool calls: Claude determines all translations upfront, then makes one script call per
string (in parallel for batches), then runs `buildStrings` exactly once.

**Tool call budget:**
- 1 string → 2 calls (script + buildStrings)
- N strings → N+1 calls (N parallel scripts + buildStrings)

## Prerequisites

1. **`wlc` CLI** — `pip install wlc`. Config at `~/.config/weblate`.
2. **`.weblate`** — project root config file with the component slug.
3. **`buildStrings`** — executable script in the project root.

## Naming Convention

Keys use `lowercased_snake_case`, starting with the feature name:
`<feature>_<context…>_<description>`

Examples: `common_cancel`, `profile_edit_save_button`, `onboarding_welcome_title`

Check your project's `CLAUDE.md` for project-specific naming conventions.

## Steps

### 1. Determine all keys, English values, and translations

Before making any tool calls:
- Choose the key(s) following the naming convention
- Write the English text
- Translate each string to every non-English language using your own translation ability.
  Produce natural, idiomatic translations appropriate for a mobile app UI — concise,
  matching the register and length of the English original.

To find what languages are configured, read `.weblate` for the component slug, then call:
```
GET /api/components/{project}/{component}/translations/
```
using the URL and token from `~/.config/weblate`. Filter out the source language (`en`).

### 2. Run the script (once per string, in parallel for batches)

```bash
bash "$HOME/.claude/skills/add-string-weblate/scripts/add-string.sh" \
  "<key>" "<english>" \
  de:"<german>" \
  fr:"<french>"
```

Pass every non-English translation as `lang:"text"` arguments. The script adds the
English source to Weblate and patches all target languages in one call.

**If any call fails or returns a non-zero exit code, stop immediately** and report the error.

### 3. Run buildStrings once

```bash
./buildStrings
```

Run this once after all script calls complete, regardless of how many strings were added.

### 4. Inform the user

For each string, show the translations and the Swift accessor:

```swift
Strings.<camelCaseKey>   // snake_case → camelCase
```

## Example — single string

**User:** "Add a save button label for the profile editing screen"

Languages configured: `de`

Translations determined upfront: `de` → "Speichern"

```bash
bash "$HOME/.claude/skills/add-string-weblate/scripts/add-string.sh" \
  "profile_edit_save_button" "Save" \
  de:"Speichern"
```

```bash
./buildStrings
```

> Done! Added `profile_edit_save_button`:
> - 🇬🇧 en: "Save" · 🇩🇪 de: "Speichern"
>
> ```swift
> Strings.profileEditSaveButton
> ```

## Example — multiple strings

**User:** "Add a title and subtitle for the onboarding welcome screen"

Languages configured: `de`

Translations determined upfront before any tool calls.

```bash
# run in parallel:
bash "$HOME/.claude/skills/add-string-weblate/scripts/add-string.sh" \
  "onboarding_welcome_title" "Welcome to MyApp" \
  de:"Willkommen bei MyApp"

bash "$HOME/.claude/skills/add-string-weblate/scripts/add-string.sh" \
  "onboarding_welcome_subtitle" "Get started in seconds." \
  de:"Leg sofort los."
```

```bash
./buildStrings
```

---
> Source: [fgeistert/skills](https://github.com/fgeistert/skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-15 -->