persian-writing skill
A skill teaches an agent to write Persian without machine clichés and lay out RTL documents: Word, PDF, PowerPoint, HTML, Excel.
- 426 ★ on the repository
- Last commit
Minimal access
Why this level
- The skill edits texts and documents and runs Python scripts.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/persian-writingDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill edits texts and documents and runs Python scripts.
This is third-party code. Review the repository files before installing.
What it does
persian-writing detects the register of a text (formal, business, colloquial, academic) and removes 18 AI-typical patterns, such as the bureaucratic «میباشد», with before and after examples. It tracks orthography: the half space, Persian «ی» and «ک», digits, quotes and ezafe. For documents the README covers right-aligned Word text, pagination without blank pages, PDF verification, PowerPoint, HTML and email, and Excel with `rightToLeft`. Scripts use the Python standard library: `persian_cleanup.py`, `fa_lint.py`, `verify_docx.py`, `verify_pdf.py`. The Vazirmatn and Lalezar fonts ship with it.
Who it is for. Copywriters, editors and analysts who write in Farsi and prepare right-to-left documents.
Good fit when
- An agent produced Persian text that sounds like a translation and needs to sound human.
- A commercial proposal must come out in Word with correct RTL and the Vazirmatn font.
- Telegram and Instagram posts are needed in Farsi with a hook, carousel or caption.
- A finished DOCX or PDF should be checked for text shift and integrity.
Not a fit when
- The text is not in Persian.
- A literary translation is needed where the translator's taste decides.
- The environment does not allow running the Python check scripts.
Example request
Rewrite this text in Farsi in a business register without machine clichés and prepare a DOCX with RTL layout in Vazirmatn.Limitations
The skill targets Persian and right-to-left documents and is useless for other languages. Automatic spell-check uses a frequency dictionary of 453 thousand words and may miss rare terms. Scripts need Python 3.8 or newer and no third-party packages. Style decisions are fixed in the skill references, so agree the tone with a native speaker when a lively voice matters. The README notes a separate universal file for chat bots, `universal/persian-writing-universal.md`.
How to disable. Delete the `~/.claude/skills/persian-writing` folder or disable the plugin. For Cursor and Windsurf remove the rule line pointing at `SKILL.md`.
FAQ
Which agents work?
Claude Code and Claude.ai take the skill or plugin, while Cursor and Windsurf read it through a rule line. For ChatGPT, Gemini and other chat bots there is a universal knowledge file.
Can I use it without AI?
Yes, the scripts run standalone: `python3 scripts/persian_cleanup.py --edit --spellcheck draft.txt` fixes and checks text and `fa_lint.py --check` gives a report.
What about fonts?
`assets/fonts` holds Vazirmatn in five weights and Lalezar under SIL OFL, and the reference has a catalogue and pairings for eight families.
Does it handle SEO texts?
Yes, the set has a section on search intent, Farsi keyword variants, E-E-A-T, a doorway page warning and a rule to write prices in tomans.
How do I check a finished DOCX or PDF?
`python3 scripts/verify_docx.py out.docx --fix --sanitize` checks RTL and file integrity. `verify_pdf.py out.pdf --expect-font Vazirmatn` checks the font in a PDF.
Discussion
No questions or reviews yet.
Related
SkillsAvoid AI Writing
avoid-ai-writing
A skill that finds typical machine-writing patterns in text and rewrites them, with detect-only and edit-in-place modes
A de-AI writing skill: it repairs the narrative architecture of fiction and edits professional documents by their venue rules
Addy Osmani skill for clearer writing: an interview and draft from your own words, a rewrite of existing text, a review that leaves the file alone
A skill for writing and editing business Japanese: clear structure, readability and removing machine-text tells
A skill that teaches an agent to write Turkish without English calques: it fixes sentence structure, collocations and UI copy
A Russian text editing skill: removes bureaucratese, calques and AI mannerisms without touching facts, with a scanner to measure the edit
README in short
The set consists of the `SKILL.md` entry point and references on style, orthography, academic writing, social networks, SEO, fonts and document formats.