Agent skill

Persian Conversational

by TronIsHere in TronIsHere/vibefarsiui

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

MITAuto-check: warningsWriting & Content

Install Persian Conversational

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

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

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

GitHub CLI
$ gh skill install TronIsHere/vibefarsiui persian-conversational --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-conversational .claude/skills/persian-conversational && 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-conversational
GitHub stars
212
Token cost
~1.5k tokens
SKILL.md length
841 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 8 steps: Decide the dial first → Verb forms (the core of the register) → Sound shifts and particles → …
  • The user asks for فارسی محاورهای، خودمونی، عامیانه، لحن دوستانه، کپشن، استوری، پیام چت
  • SKILL.md covers 1. Decide the dial first, 2. Verb forms (the core of the…, 3. Sound shifts and particles and 4. What does NOT change in…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Persian Conversational is an agent skill from TronIsHere/vibefarsiui. Write colloquial written Persian (محاورهنویسی): the Farsi people actually type in chat, Instagram captions, Telegram posts, consumer-app onboarding and friendly support replies. Use whenever the user asks for فارسی محاورهای، خودمونی، عامیانه، لحن دوستانه، کپشن، استوری، پیام چت, or when the product voice is casual. Not for contracts, invoices, official letters or academic text (use persian-formal for those).

Its SKILL.md is about 1.5k 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 Writing & Content, covering Forms and invoices, Social media posts and Customer support. It works with Telegram. The licence is MIT.

When your agent uses it

  • The user asks for فارسی محاورهای، خودمونی، عامیانه، لحن دوستانه، کپشن، استوری، پیام چت
  • The product voice is casual

Example prompts

  • “/persian-conversational”

Workflow steps

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

  1. Decide the dial first
  2. Verb forms (the core of the register)
  3. Sound shifts and particles
  4. What does NOT change in colloquial
  5. The هکسره trap
  6. Tone limits
  7. Before / after
  8. Checklist before you return text

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 Conversational loads about 1.5k tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 841 words of instructions outside code blocks.

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

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:4
    Write colloquial written Persian (محاوره⟨U+200C⟩نویسی): the Farsi people actually type
  • WarningContains zero-width charactersSKILL.md:6
    whenever the user asks for فارسی محاوره⟨U+200C⟩ای،
  • WarningContains zero-width charactersSKILL.md:12
    # Conversational Persian (فارسی محاوره⟨U+200C⟩ای)
  • WarningContains zero-width charactersSKILL.md:26
    cs, newsletters | spoken forms: میشه، می⟨U+200C⟩تونید، داره | keep «را», keep «این/آن⟨U+200C⟩ها» | «روی اسمش بزنید تا کد را ببینید.» |
  • WarningContains zero-width charactersSKILL.md:37
    | است | ـه (خوبه، آماده⟨U+200C⟩ست) |
  • WarningContains zero-width charactersSKILL.md:39
    | می⟨U+200C⟩شود / نمی⟨U+200C⟩شود | میشه / نمیشه |
  • WarningContains zero-width charactersSKILL.md:40
    | می⟨U+200C⟩خواهم / می⟨U+200C⟩خواهی | می⟨U+200C⟩خوام / می⟨U+200C⟩خوای |
  • WarningContains zero-width charactersSKILL.md:41
    | می⟨U+200C⟩توانم / می⟨U+200C⟩توانید | می⟨U+200C⟩تونم / می⟨U+200C⟩تونید |
  • WarningContains zero-width charactersSKILL.md:42
    | می⟨U+200C⟩روم / می⟨U+200C⟩رود | میرم / میره |
  • WarningContains zero-width charactersSKILL.md:43
    | می⟨U+200C⟩گویم / می⟨U+200C⟩گوید | میگم / میگه |

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). 841 words, ~1,489 tokens.

Download SKILL.mdSave it as .claude/skills/persian-conversational/SKILL.md (or your agent's skills folder).
name
persian-conversational
description
Write colloquial written Persian (محاوره‌نویسی): the Farsi people actually type in chat, Instagram captions, Telegram posts, consumer-app onboarding and friendly support replies. Use whenever the user asks for فارسی محاوره‌ای، خودمونی، عامیانه، لحن دوستانه، کپشن، استوری، پیام چت, or when the product voice is casual. Not for contracts, invoices, official letters or academic text (use persian-formal for those).

Conversational Persian (فارسی محاورهای)

Written Persian has two live registers. Formal (کتابی) is what models default to; colloquial (محاوره) is what Iranians type to each other. Mixing them in one text is the fastest way to sound like a machine. This skill is for the second register only.

1. Decide the dial first

Colloquial is not one setting. Pick the level from the destination, then hold it for the whole piece.

LevelWhereVerbsرا / آنExample
Light (نرم)Product UI, landing copy, docs, newslettersspoken forms: میشه، میتونید، دارهkeep «را», keep «این/آنها»«روی اسمش بزنید تا کد را ببینید.»
Full (خودمونی)Chat replies, Instagram, Telegram, stories, friendly DMsspoken forms + clipped«رو», «اون/اونا/اینا»«اون فایل رو فرستادم، ببین رسید؟»

If the user only said «خودمونی باشه», default to Light for anything that lives inside a product and Full for anything that lives inside a chat or social feed.

2. Verb forms (the core of the register)

Written (کتابی)Spoken (محاوره)
استـه (خوبه، آمادهست)
هستند / نیستندهستن / نیستن
میشود / نمیشودمیشه / نمیشه
میخواهم / میخواهیمیخوام / میخوای
میتوانم / میتوانیدمیتونم / میتونید
میروم / میرودمیرم / میره
میگویم / میگویدمیگم / میگه
میدهم / میدهدمیدم / میده
میآید / میآیندمیاد / میان
بگذار / بگذاریدبذار / بذارید
خواهم رفت (future)میرم (present does the job)

Second person plural stays polite and warm: «شما بگید»، «میتونید ببینید». Stacked formality («جنابعالی میتوانید ملاحظه بفرمایید») is a different register; never mix it in.

3. Sound shifts and particles

  • ان → ون in everyday words: خانه → خونه، نان → نون، دندان → دندون، زمان → زمون (in Full only). Do not shift proper nouns or abstract words: «ایران»، «زبان»، «سازمان» stay as they are.
  • این / آن: Light keeps «این / آن»; Full uses «این / اون», plurals «اینا / اونا».
  • چه → چی, برای → واسه (Full only; «برای» is still fine everywhere).
  • Particles carry the music. Use them where a person would, not in every sentence: دیگه (come on / already)، که (emphasis: «گفتم که»)، ها (attention: «یادت نره ها»)، مگه (surprise: «مگه میشه؟»)، خب، حالا، راستش، یعنی، ببین.
  • Reactions in chat are single beats: «جدی؟»، «عالیه»، «دمت گرم»، «وای».

4. What does NOT change in colloquial

Colloquial is a register, not a licence to be sloppy. All of this still applies:

  • ZWNJ (نیمفاصله, U+200C): میخوام، نمیتونم، بچهها، خونهمون. «می خوام» with a space is wrong in every register.
  • Persian letters only: ی (U+06CC) not ي, ک (U+06A9) not ك.
  • Persian digits inside prose: «۳ تا سفارش»، «ساعت ۱۰». Latin digits stay in codes, URLs and version numbers.
  • Punctuation: «،» «؟» and «گیومه» for quotes. No em dashes (—); they are an English-model tell. Use «،» or start a new sentence.
  • Register consistency: never «میشه» in one sentence and «میشود» in the next. One artifact, one register.

5. The هکسره trap

Colloquial is exactly where the «ـه» clitic (= است) lives, so it is also where writers collide it with the ezafe kasre. This single error gets screenshotted.

WrongRightWhy
کتابه منکتابِ منezafe, not «است»
خونهی ما قشنگهخونهی ما قشنگه«قشنگه» = قشنگ است, correct
ماشینه علیماشینِ علیezafe
این ماشینهاین ماشینه«= این ماشین است», correct

Test: replace «ـه» with «است». If the sentence survives, «ـه» is right; if it breaks, you needed a kasre (write the word without «ه», optionally with a visible kasre for clarity).

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

6. Tone limits

  • تو vs شما: default to «شما» with spoken verbs for customers, followers and strangers («شما بگید چی میخواید»). Use «تو» only when the brand already talks like a friend and the user asked for it.
  • Slang budget: everyday words are fine (عالیه، کلی، یه عالمه، حله). Street slang (داش، خفن، باحال) only if the brand voice already uses it.
  • تعارف: one beat maximum («قابلی نداره»). Three rituals in a DM read as a bot imitating politeness.
  • Still banned (they are AI tells in any register): «در دنیای امروز» openers, rule-of-three lists (سریع، آسان و مطمئن), «نه تنها … بلکه», emoji on every line, «امیدوارم مفید بوده باشه» closers.

7. Before / after

Prompt: «یه پیام خوشآمد برای اولین ورود کاربر بنویس»

Formal-by-default (wrong for a consumer app):

کاربر گرامی، به اپلیکیشن ما خوش آمدید. لطفاً جهت شروع، پروفایل خود را تکمیل نمایید.

Light colloquial (product UI):

خوش اومدید! برای شروع، پروفایلتون را کامل کنید تا سفارش اول را ثبت کنیم.

Full colloquial (chat / social):

سلام! خوش اومدی. اول پروفایلت رو کامل کن، بعدش بریم سراغ سفارش اول.

Prompt: «جواب پشتیبانی به کاربری که میگه کد تأیید نرسیده»

سلام، ببخشید که معطل شدید. گاهی پیامک تا یک دقیقه دیر میاد. اگه هنوز نرسیده، روی «ارسال دوباره» بزنید. اگه باز هم نیومد، همینجا بگید تا از سمت ما بررسی کنیم.

8. Checklist before you return text

  1. Register chosen (Light or Full) and held from first word to last.
  2. No «میشود / است / نمایید» leaking into a colloquial piece.
  3. ZWNJ in every compound verb and plural.
  4. Every «ـه» passes the «است» test.
  5. Persian digits, «گیومه», no em dashes.
  6. Read it aloud: would an Iranian type this to a friend or customer?

See also: the persian-writing skill by ali2000hos for the full treatment of registers, AI-tell removal and Persian documents.

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

Files

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

Open the folder on GitHubat commit 7d56b50

Compare with similar skills

Persian Conversational 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 Conversational compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Persian Conversational this skillTronIsHere/vibefarsiui212—~1.5kAutomated safety check: WarnMIT
PostN1arko/redaktura-skills168—~1.3kAutomated safety check: PassCustom licence
X/Twitter Research via Grokartwist-polyakov/polyakov-claude-skills208—~1.8kAutomated safety check: NotesMIT
Social Publishingwshobson/agents40k—~914Automated safety check: PassMIT
Reply Makeraeonfun/aeon770—~6kAutomated safety check: PassMIT
Write Tweetaeonfun/aeon770—~8.8kAutomated safety check: PassMIT

Similar skills

  • Post

    N1arko/redaktura-skills

    Короткие русскоязычные посты для Telegram, LinkedIn, Instagram и других соцсетей: пост с нуля, пост из статьи, анонс в канал, переписывание первой строки, усиление хука и финала.

    168 GitHub stars~1.3k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • X/Twitter Research via Grok

    artwist-polyakov/polyakov-claude-skills

    Searches X/Twitter through the xAI Grok API to build digests, trend reports and thread analysis, meant to surface post ideas for a Telegram channel.

    208 GitHub stars~1.8k tokensUpdated yesterday
    Writing & ContentAuto-check: notes
  • Social Publishing

    wshobson/agents

    Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API.

    40k GitHub stars~914 tokensUpdated 5 days ago
    Writing & ContentAuto-check passed
  • Reply Maker

    aeonfun/aeon

    Draft copy-paste-ready X replies - two options per reply-worthy tweet from tracked accounts, topics, or lists (default), or ready-to-post responses to engagement opps in recent logs (from-logs)

    770 GitHub stars~6k tokensUpdated today
    Writing & ContentAuto-check passed
  • Write Tweet

    aeonfun/aeon

    Multi-format tweet studio - standalone drafts (10 across 5 size tiers), a 5-10 tweet thread, or 10 remixes of past tweets, selected via ${var}

    770 GitHub stars~8.8k tokensUpdated today
    Writing & ContentAuto-check passed
  • Postfast

    LeoYeAI/openclaw-master-skills

    Schedule and manage social media posts across TikTok, Instagram, Facebook, X (Twitter), YouTube, LinkedIn, Threads, Bluesky, Pinterest, and Telegram using the PostFast API.

    2.2k GitHub stars~4.8k tokensUpdated 2 mo ago
    Writing & ContentAuto-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 Formal

    TronIsHere/vibefarsiui

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

    212 GitHub stars~1.7k 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 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

Works with

Questions about Persian Conversational

What does Persian Conversational do?

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

When should I use Persian Conversational?

Persian Conversational fits situations like: the user asks for فارسی محاورهای، خودمونی، عامیانه، لحن دوستانه، کپشن، استوری، پیام چت; the product voice is casual.

How do I install Persian Conversational in Claude Code?

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

How do I install Persian Conversational in Codex?

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

Can I use Persian Conversational 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-conversational -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-conversational, .gemini/skills/persian-conversational, .github/skills/persian-conversational and .opencode/skills/persian-conversational in your project.

What does Persian Conversational need to run?

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

Does Persian Conversational 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 Conversational 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 Conversational use?

Persian Conversational 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 Conversational use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Conversational?

Skills that share tags, products or a category with Persian Conversational: Post (N1arko/redaktura-skills, 168 stars), X/Twitter Research via Grok (artwist-polyakov/polyakov-claude-skills, 208 stars), Social Publishing (wshobson/agents, 40k stars) and Reply Maker (aeonfun/aeon, 770 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Persian Conversational?

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.