Agent skill

Persian Formal

by TronIsHere in TronIsHere/vibefarsiui

Write formal Persian that still sounds human: proposals, contracts, invoices, official letters (نامه اداری), formal email, company website copy, terms and policies.

MITAuto-check: warningsDocuments & Office

Install Persian Formal

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add TronIsHere/vibefarsiui --skill persian-formal -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TronIsHere/vibefarsiui persian-formal --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TronIsHere/vibefarsiui.git skills-src && mkdir -p .claude/skills && cp -r skills-src/registry/skills/persian-formal .claude/skills/persian-formal && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
persian-formal
GitHub stars
212
Token cost
~1.7k tokens
SKILL.md length
891 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Write formal Persian that still sounds human: proposals, contracts, invoices, official letters (نامه اداری), formal email, company website copy, terms and policies.

  • Works in 9 steps: Two formal registers → Verb and vocabulary rules → Banned phrases (bureaucratic and AI tells) → …
  • The user asks for فارسی رسمی، اداری، نامه، پروپوزال، قرارداد، فاکتور، متن حقوقی
  • SKILL.md covers 1. Two formal registers, 2. Verb and vocabulary rules, 3. Banned phrases… and 4. نامه اداری (letter to an…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Persian Formal is an agent skill from TronIsHere/vibefarsiui. Write formal Persian that still sounds human: proposals, contracts, invoices, official letters (نامه اداری), formal email, company website copy, terms and policies. Use whenever the user asks for فارسی رسمی، اداری، نامه، پروپوزال، قرارداد، فاکتور، متن حقوقی, or when the text goes to a client, organization, university or government office. Bans the bureaucratic tells (میباشد، لازم به ذکر است) that make Persian sound machine-written.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Forms and invoices and Proposals and quotes. The licence is MIT.

When your agent uses it

  • The user asks for فارسی رسمی، اداری، نامه، پروپوزال، قرارداد، فاکتور، متن حقوقی
  • The text goes to a client
  • Government office

Example prompts

  • “/persian-formal”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Two formal registers
  2. Verb and vocabulary rules
  3. Banned phrases (bureaucratic and AI tells)
  4. نامه اداری (letter to an organization)
  5. Formal email
  6. Invoices, contracts, terms
  7. Orthography (non-negotiable)
  8. Before / after
  9. Checklist

What it can do on your machine

Read from SKILL.md and the folder at commit 7d56b50. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Persian Formal loads about 1.7k tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 891 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningContains zero-width charactersSKILL.md:8
    office. Bans the bureaucratic tells (می⟨U+200C⟩باشد، لازم به
  • WarningContains zero-width charactersSKILL.md:23
    company site, product docs | است، شد، می⟨U+200C⟩شود؛ short sentences; concrete claims |
  • WarningContains zero-width charactersSKILL.md:31
    - **است، شد، کرد، می⟨U+200C⟩شود**. Never «می⟨U+200C⟩باشد»، «گردید»، «به عمل آورد»، «قرار دارد»
  • WarningContains zero-width charactersSKILL.md:32
    (for است)، «محسوب می⟨U+200C⟩شود»، «به شمار می⟨U+200C⟩رود». These are government-office
  • WarningContains zero-width charactersSKILL.md:36
    - Address the reader: «شما می⟨U+200C⟩توانید» not «کاربران محترم می⟨U+200C⟩توانند».
  • WarningContains zero-width charactersSKILL.md:37
    over ceremonial: «سایت در ۳ ثانیه باز می⟨U+200C⟩شود» beats «بهبود چشمگیر
  • WarningContains zero-width charactersSKILL.md:40
    «جهت»، «درباره⟨U+200C⟩ی» not «در خصوص»، «به همین دلیل» not «از این رو».
  • WarningContains zero-width charactersSKILL.md:42
    «به⟨U+200C⟩ناچار» not «ناچاراً». Real Arabic loans keep it: واقعاً، حتماً، لطفاً.
  • WarningContains zero-width charactersSKILL.md:52
    | از اهمیت ویژه⟨U+200C⟩ای برخوردار است / نقش بسزایی ایفا می⟨U+200C⟩کند | the concrete claim |
  • WarningContains zero-width charactersSKILL.md:54
    | در نهایت می⟨U+200C⟩توان گفت / به طور کلی | end with a fact or a next step |

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TronIsHere/vibefarsiui at commit 7d56b50, republished under its MIT licence (© TronIsHere). 891 words, ~1,723 tokens.

Download SKILL.mdSave it as .claude/skills/persian-formal/SKILL.md (or your agent's skills folder).
name
persian-formal
description
Write formal Persian that still sounds human: proposals, contracts, invoices, official letters (نامه اداری), formal email, company website copy, terms and policies. Use whenever the user asks for فارسی رسمی، اداری، نامه، پروپوزال، قرارداد، فاکتور، متن حقوقی, or when the text goes to a client, organization, university or government office. Bans the bureaucratic tells (می‌باشد، لازم به ذکر است) that make Persian sound machine-written.

Formal Persian (فارسی رسمی و اداری)

Formal Persian is the register models get most wrong, in the opposite direction from what you would expect: they produce something more bureaucratic than any working Iranian writer would. Formal means full written forms, «شما», no slang. It does not mean ceremony.

1. Two formal registers

RegisterWhereMarker
Formal-but-human (رسمی روان)Proposal, contract, invoice, terms, B2B email, company site, product docsاست، شد، میشود؛ short sentences; concrete claims
Formal-administrative (اداری)Letter to an organization, ministry, university, bankSame verbs plus the fixed letter furniture in section 4

Default with no signal: formal-but-human. Casual by mistake is worse than formal by mistake when the text leaves the team.

2. Verb and vocabulary rules

  • است، شد، کرد، میشود. Never «میباشد»، «گردید»، «به عمل آورد»، «قرار دارد» (for است)، «محسوب میشود»، «به شمار میرود». These are government-office fossils; in a proposal they read as lazy or machine-generated.
  • Short sentences, one idea each. Persian tolerates long chains of «که»; readers do not.
  • Address the reader: «شما میتوانید» not «کاربران محترم میتوانند».
  • Concrete over ceremonial: «سایت در ۳ ثانیه باز میشود» beats «بهبود چشمگیر سرعت بارگذاری را تجربه خواهید کرد».
  • Persian words where a Persian word exists and is natural: «برای» not «جهت»، «دربارهی» not «در خصوص»، «به همین دلیل» not «از این رو».
  • No fake tanvin on Persian words: «گاهی» not «گاهاً»، «دوم اینکه» not «دوماً»، «بهناچار» not «ناچاراً». Real Arabic loans keep it: واقعاً، حتماً، لطفاً.

3. Banned phrases (bureaucratic and AI tells)

Cut on sight; say the thing instead.

TellReplace with
لازم به ذکر است که / شایان ذکر است(delete; state the fact)
در راستای / در همین راستا / در جهت نیل بهبرای
از اهمیت ویژهای برخوردار است / نقش بسزایی ایفا میکندthe concrete claim
در دنیای امروز / در عصر دیجیتال / امروزه با پیشرفت تکنولوژیstart with the point
در نهایت میتوان گفت / به طور کلیend with a fact or a next step
بینظیر / منحصربهفرد / تجربهای متفاوتa number, a name, or nothing
کارشناسان معتقدند / مطالعات نشان میدهد (no source)name the source or drop it
سریع، آسان و مطمئن (any triad)two items, or one developed idea
نه تنها … بلکهthe positive claim, plainly
که نشاندهندهی … است (tacked on)its own sentence with evidence, or delete
— (em dash)«،» or a new sentence

Also: no «همچنین» opening three sentences in a row, no bold-header bullet lists («سرعت: توضیح») in prose, no «امیدوارم مفید بوده باشد» closers.

4. نامه اداری (letter to an organization)

The fixed furniture is the register. Use it once, correctly.

text
موضوع: درخواست صدور مجوز نصب تابلو

مدیریت محترم [نام واحد]
[نام سازمان]

با سلام و احترام؛

خواهشمند است دستور فرمایید مجوز نصب تابلوی شرکت [نام] در نشانی [نشانی]
صادر شود. مدارک لازم پیوست است.

با تشکر و احترام
[نام و نام خانوادگی]
[سمت]
[تاریخ شمسی]
  • Order: موضوع ← گیرنده با سمت ← «با سلام و احترام؛» ← body (short, one request per letter) ← closing formula ← نام، سمت، تاریخ.
  • Honorifics: «جناب آقای» / «سرکار خانم» + [دکتر / مهندس] + surname; «مدیریت محترم …»، «ریاست محترم …». Never first names, never «تو».
  • Openers: «با سلام و احترام؛» or «احتراماً، به استحضار میرساند …». One «احتراماً» at most; stacking ceremony reads as parody.
  • Request formula: «خواهشمند است دستور فرمایید …» is correct here and only here.
  • Closers: «با تشکر و احترام»، «پیشاپیش از همکاری شما سپاسگزارم».
  • Body verbs stay «است / میشود». اداری does not excuse «میباشد».

5. Formal email

text
موضوع: پیشفاکتور طراحی سایت، ویرایش دوم

سلام آقای رضایی،

پیشفاکتور اصلاحشده پیوست است. دو تغییر نسبت به نسخهی قبل:
۱. مبلغ پشتیبانی سالانه از ۱۲ به ۹ میلیون تومان کاهش یافت.
۲. زمان تحویل ۲۰ مهر ۱۴۰۵ است.

اگر تأیید میکنید، قرارداد را تا فردا ارسال میکنم.

با احترام
سارا کریمی

Subject line states the content. Greeting is «سلام آقای / خانم [surname]،». One warm line is enough. Sign with name and, if relevant, role.

Show full SKILL.md (357 more words)Show less

6. Invoices, contracts, terms

  • Column and field names are standard: «شرح»، «تعداد»، «مبلغ واحد»، «جمع»، «تخفیف»، «مالیات بر ارزش افزوده»، «مبلغ قابل پرداخت».
  • State the unit explicitly and once: «همهی مبالغ به تومان است». Never mix تومان and ریال in one document.
  • Amounts that matter (cheques, contracts) also appear in words: «۱۲٬۵۰۰٬۰۰۰ تومان (دوازده میلیون و پانصد هزار تومان)».
  • Dates are Jalali in the official form «۲۹ شهریور ۱۴۰۵» or «۱۴۰۵/۰۶/۲۹». Add the Gregorian date only if the counterparty is outside Iran.
  • Contract clauses: «مادهی ۱»، «تبصره»، «طرف اول / طرف دوم». Keep obligations as plain sentences with a subject; passive that hides the actor («تصمیم گرفته شد») is a defect in a contract.
  • Terms and privacy pages address the user as «شما» and the company as «ما» consistently; do not slide between «کاربر» and «شما» in one section.

7. Orthography (non-negotiable)

  • ZWNJ (نیمفاصله): میشود، شرکتها، بهعنوان، پیشفاکتور.
  • Persian ی and ک, Persian digits ۰–۹ in prose, «٬» as thousands separator, «٪» after the number.
  • «گیومه» for quotes, «،» and «؛» as punctuation, no space before them.
  • The ezafe is never written as «ـه» («قراردادِ فروش» not «قرارداده فروش»).

8. Before / after

Prompt: «متن معرفی شرکت برای صفحهی دربارهی ما»

❌ شرکت ما در راستای ارائهی خدمات نوین، با بهرهگیری از تیمی مجرب و متخصص، همواره در تلاش میباشد تا تجربهای بینظیر برای مشتریان خود رقم بزند.

✅ از ۱۳۹۸ برای فروشگاههای آنلاین سایت میسازیم. تا امروز ۴۰ فروشگاه تحویل دادهایم و سهتای آنها روزی بیش از هزار سفارش دارند. تیم ما هفت نفر است و هر پروژه یک مدیر مشخص دارد که پاسخگوی شماست.

(Use only facts the user gave. If there are none, write the structure and mark the blanks; never invent counts, years or client names.)

9. Checklist

  1. Register chosen: رسمی روان or اداری, held throughout.
  2. Zero «میباشد / گردید / لازم به ذکر است / در راستای».
  3. No triads, no em dashes, no generic openers or closers.
  4. Numbers, dates and units Persian and explicit; unit stated once.
  5. Letter furniture complete and used once (اداری only).
  6. Every claim traceable to the brief.

See also: the persian-writing skill by ali2000hos for register detection, academic Persian and RTL Word/PDF output.

© TronIsHere, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. 49 hidden characters (zero-width or bidirectional) removed. Raw file

Files

Just SKILL.md in registry/skills/persian-formal of TronIsHere/vibefarsiui.

Open the folder on GitHubat commit 7d56b50

Compare with similar skills

Persian Formal next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Persian Formal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Persian Formal this skillTronIsHere/vibefarsiui212—~1.7kAutomated safety check: WarnMIT
HoneybookLeoYeAI/openclaw-master-skills2.2k—~499Automated safety check: PassMIT
Quotation GeneratoriPythoning/b2b-sdr-agent-template190—~450Automated safety check: PassMIT
Sow Pws Builderaiskillstore/marketplace433—~3.1kAutomated safety check: PassNone
Form Fillingplatonai/Browser41.2k—~1.1kAutomated safety check: PassApache-2.0
Code2mediatsingliuwin/autoclaw283—~956Automated safety check: PassMIT

Similar skills

  • Honeybook

    LeoYeAI/openclaw-master-skills

    This skill should be used when the user asks about HoneyBook client-portal data.

    2.2k GitHub stars~499 tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Quotation Generator

    iPythoning/b2b-sdr-agent-template

    Auto-generate professional PDF proforma invoices with company letterhead, multi-language support, and post-quote tracking.

    190 GitHub stars~450 tokensUpdated 11 days ago
    Documents & OfficeAuto-check passed
  • Sow Pws Builder

    aiskillstore/marketplace

    Trigger for: writing, revising, converting, or descoping a federal Statement of Work, Performance Work Statement, SOW, PWS, or SOO; develop executable requirements; define contract scope; create…

    433 GitHub stars~3.1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Form Filling

    platonai/Browser4

    Automatically fills web forms using provided field data and can optionally submit the form.

    1.2k GitHub stars~1.1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Code2media

    tsingliuwin/autoclaw

    Universal media renderer with no fixed template — any custom layout, size or style becomes pixel-perfect images (PNG/JPEG/WebP), vector SVG, paged PDFs or animations (WebP/GIF).

    283 GitHub stars~956 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Token Receipt

    Hchen1218/token-receipt

    A skill your agent uses when the user wants to view AI conversation token usage as a receipt, invoice, checkout slip, token bill, usage receipt, cost snapshot, or creative monospace thermal-paper…

    126 GitHub stars~2.1k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed

More from TronIsHere/vibefarsiui

  • Iran Validation

    TronIsHere/vibefarsiui

    Validate and format Iranian identifiers correctly: national ID (کد ملی) checksum, mobile numbers (۰۹…), landlines with area codes, IBAN / Sheba (شبا) mod-97, bank card numbers with Luhn and…

    212 GitHub stars~1.8k tokensUpdated today
    Auto-check: warnings
  • Jalali Calendar

    TronIsHere/vibefarsiui

    Handle dates and times for Iranian users: the Jalali / Solar Hijri calendar (تقویم شمسی، هجری خورشیدی), Saturday-first weeks, Tehran time (+03:30, no DST), Persian month and weekday names…

    212 GitHub stars~1.6k tokensUpdated today
    Auto-check: warnings
  • Persian SEO

    TronIsHere/vibefarsiui

    Technical and on-page SEO for Persian (Farsi) websites: lang and hreflang for fa-IR, RTL-safe metadata, Persian titles and descriptions, slug and URL strategy for Persian content, ZWNJ and keyword…

    212 GitHub stars~1.7k tokensUpdated today
    Auto-check: warnings
  • Persian Conversational

    TronIsHere/vibefarsiui

    Write colloquial written Persian (محاورهنویسی): the Farsi people actually type in chat, Instagram captions, Telegram posts, consumer-app onboarding and friendly support replies.

    212 GitHub stars~1.5k tokensUpdated today
    Auto-check: warnings
  • Persian Rtl UI

    TronIsHere/vibefarsiui

    Build right-to-left Persian (Farsi) UI in React and Tailwind the way an Iranian product team would: logical CSS only, Persian fonts without letter-spacing, Persian digits and «تومان», Jalali dates…

    212 GitHub stars~1.7k tokensUpdated today
    Auto-check: warnings
  • Persian UI Copy

    TronIsHere/vibefarsiui

    Write Persian (Farsi) UI microcopy: button labels, field labels and placeholders, validation and error messages, empty states, loading and success toasts, confirmations, notifications.

    212 GitHub stars~1.6k tokensUpdated today
    Auto-check: warnings

Questions about Persian Formal

What does Persian Formal do?

Write formal Persian that still sounds human: proposals, contracts, invoices, official letters (نامه اداری), formal email, company website copy, terms and policies. Persian Formal is an agent skill from TronIsHere/vibefarsiui. Write formal Persian that still sounds human: proposals, contracts, invoices, official letters (نامه اداری), formal email, company website copy, terms and policies.

When should I use Persian Formal?

Persian Formal fits situations like: the user asks for فارسی رسمی، اداری، نامه، پروپوزال، قرارداد، فاکتور، متن حقوقی; the text goes to a client; government office.

How do I install Persian Formal in Claude Code?

Run `npx skills add TronIsHere/vibefarsiui --skill persian-formal -a claude-code`. Or copy the skill folder (registry/skills/persian-formal in TronIsHere/vibefarsiui) into .claude/skills/persian-formal in your project. Claude Code loads it when a task matches its description.

How do I install Persian Formal in Codex?

Run `npx skills add TronIsHere/vibefarsiui --skill persian-formal -a codex`. Or copy the skill folder (registry/skills/persian-formal in TronIsHere/vibefarsiui) into .agents/skills/persian-formal in your project. Codex loads it when a task matches its description.

Can I use Persian Formal in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TronIsHere/vibefarsiui --skill persian-formal -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/persian-formal, .gemini/skills/persian-formal, .github/skills/persian-formal and .opencode/skills/persian-formal in your project.

What does Persian Formal need to run?

SKILL.md names no scripts, command-line tools or credentials: Persian Formal is instructions for the agent only.

Does Persian Formal access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Persian Formal safe to install?

Our automated static check of SKILL.md flagged 10 warning(s): contains zero-width characters. Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Persian Formal use?

Persian Formal is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Persian Formal use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Persian Formal?

Skills that share tags, products or a category with Persian Formal: Honeybook (LeoYeAI/openclaw-master-skills, 2.2k stars), Quotation Generator (iPythoning/b2b-sdr-agent-template, 190 stars), Sow Pws Builder (aiskillstore/marketplace, 433 stars) and Form Filling (platonai/Browser4, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Persian Formal?

TronIsHere (a GitHub user) maintains it in TronIsHere/vibefarsiui, which has 212 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 10, 2026.

Source: TronIsHere/vibefarsiui on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.