shervinshirkubi

Native Farsi — Development skill for Claude Code

Development community

Claude skill for writing natural, authentic Persian (Farsi), not translated-sounding text.

How to install Native Farsi

This entry records only its repository, not the path inside it, so there is no exact command to give. Open shervinshirkubi/native-farsi and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Native Farsi does

Claude skill for writing natural, authentic Persian (Farsi), not translated-sounding text.

Alternatives in Development

Internet Court Skill — The trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 4.9k ★
Auto — Smart router - Single entry point with natural language intent detection 2.8k ★
Shortcuts Playground Plugin — Shortcuts Playground: A Claude Code and Codex plugin for building, validating, signing, and remixing macOS/iOS 1.1k ★

README

native-farsi

A [Claude](https://claude.ai) skill for writing natural, authentic Persian (Farsi) — not text that sounds translated from English.

**[فارسی ⬇️](#فارسی)**

![Before/after: three sentences rewritten from translated-sounding Persian to natural Persian](docs/before-after.png)

The problem

Language models writing Persian usually carry over English syntax with Persian words: noun-heavy sentences instead of verb-centered ones, overused passive voice, translation-cliché phrases («این نشان می‌دهد که…» — "this shows that…"), and mixed register (formal and colloquial forms in the same sentence).

This skill builds its rules from **observing real Persian**, not by analogy with English.

What's in it

Automatic register detection from the text's destination (spoken, casual written, explanatory, formal)
Anti-calque rules: words and structures that smell like translation
Register consistency: a mechanical check against mixing literary and colloquial forms
Discourse layer: issues above the sentence level (information order, pronoun reference)
Storytelling: scene, character, suspense, throughline
Quantitative rhythm gauge: measures sentence-length variance
Right-to-left documents: Word, PowerPoint, PDF, HTML (with automated verify scripts)
Every rule is graded: 🔴 absolute · 🟡 register-dependent · 🔵 diagnostic (a signal, not a verdict)

Two more examples the image can't show

**Discourse layer** (a whole paragraph's reference chain, not a single sentence):

❌ "حالا اینو ببر بیرون از دوجو." — the pronoun has nothing to point back to. ✅ "حالا همین الگو رو می‌شه برد بیرون دوجو." — the referent is named.

**Right-to-left document layout** (not text — page structure): a Word file with mirrored alignment, Persian digits in numbered lists, no font fallback to DejaVu, verified automatically by `scripts/verify_docx.py` before delivery.