salsi — скилл

---
name: salsi
description: Write Persian with Persian words. Use when writing, editing, translating or reviewing Persian (Farsi) prose — articles, documentation, posts, essays, UI copy — to replace loanwords with Persian equivalents while leaving technical terminology, proper nouns and code untouched. Also use when the user asks for پارسی سره, سره‌نویسی, فارسی‌سازی, or "make this text more Persian".
license: MIT
---

# سالسی — Write Persian with Persian words

Persian prose is full of borrowed words that have perfectly good Persian
equivalents. Replacing them makes writing clearer and more native. Replacing
them *carelessly* makes writing wrong — it mangles technical terms, changes
meaning, and produces words no reader recognises.

This skill is about the difference.

## The one rule that matters

**A loanword is only worth replacing when the replacement is at least as clear
to the reader.** Purity is never worth clarity. If you are unsure whether a
reader would recognise the Persian equivalent, keep the original.

## Workflow

1. **Scan** the text to find candidates:

   ```bash
   salsi scan article.md --format json
   ```

   If `salsi` is not on PATH, this skill ships its own copy — run
   `./bin/salsi` from this skill's directory instead. It needs nothing
   installed beyond Python 3.10 and carries the full 20,129-word lexicon.

   Add `--domain tech` (or `medical`, `legal`, `science`, `business`) so the
   terminology of that field is protected. Add `--topic <subject>` to help the
   scanner pick the right sense of an ambiguous word.

2. **Read each finding.** Every one carries `level`, `ambiguous`, and a `sense`
   label per suggestion. Apply the judgement rules below. Most findings will be
   *rejected* in a technical document — that is the expected outcome, not a
   failure.

3. **Apply** with your normal editing tools, one considered change at a time.
   For the settled subset only, `salsi apply article.md` does it mechanically.