۱۴ مهارت و راهنما

مهارت‌ها

مهارت یک فایل مارک‌داون هست که Claude Code، Cursor و Codex قبل از کار می‌خونن. این‌ها را برای کارهای فارسی نوشتیم: فارسی محاوره‌ای، متن دکمه و خطا، تقویم شمسی، کد ملی و شبا، هر کدام یک فایل. روی اسمش بزنید تا متن کامل و راه نصب را ببینید.

  • فارسی محاوره‌ایمهارتpersian-conversational

    به مدل یاد میده فارسی خودمونی بنویسه، همان‌طور که توی چت و اینستاگرام می‌نویسیم: میشه، می‌خوام، رو، دیگه. با جدول تبدیل فعل‌ها، دو سطح نرم و خودمونی، و تله‌ی هکسره.

    • کپشن اینستاگرام و پست تلگرام
    • پیام‌های آنبوردینگ و اعلان‌های اپ مصرفی
    • جواب پشتیبانی توی چت
    نوشتنمحاورهشبکه‌های اجتماعی
    $npx vibefarsi add persian-conversational
  • فارسی رسمی و اداریمهارتpersian-formal

    فارسی رسمی ولی آدمیزادی: است به‌جای می‌باشد، جمله‌های کوتاه و ادعای مشخص. قالب نامه‌ی اداری، ایمیل رسمی و متن فاکتور و قرارداد هم داخلشه.

    • نامه به سازمان، اداره یا دانشگاه
    • پروپوزال و قرارداد برای مشتری
    • ایمیل رسمی و متن فاکتور
    نوشتنرسمینامه‌ی اداری
    $npx vibefarsi add persian-formal
  • متن رابط کاربریمهارتpersian-ui-copy

    دکمه، لیبل، پیام خطا، حالت خالی و توست به فارسی درست. با واژه‌نامه‌ی رابط کاربری تا Login بشه «ورود» و Submit بشه «ثبت»، نه «ارسال نمایید».

    • ساخت هر فرم یا صفحه‌ای که متن داره
    • پیام خطا و اعتبارسنجی
    • حالت خالی، لودینگ و توست
    نوشتنفرمپیام خطا
    $npx vibefarsi add persian-ui-copy
  • رابط راست‌چینمهارتpersian-rtl-ui

    همان قوانین طراحی وایب‌فارسی، به شکل یک مهارت: راست‌چین با کلاس‌های منطقی، فونت فارسی بدون letter-spacing، اعداد فارسی و تومان، فرم ایرانی و رنگ فقط از توکن. برای پروژه‌هایی که MCP ندارن.

    • ساخت هر صفحه یا کامپوننت React با Tailwind
    • تبدیل قالب چپ‌چین به راست‌چین
    • وقتی مدل ml- و text-left می‌نویسه
    ReactTailwindراست‌چین
    $npx vibefarsi add persian-rtl-ui
  • تقویم شمسیمهارتjalali-calendar

    هفته از شنبه شروع میشه، سال با نوروز، و ساعت تهران +۳:۳۰ بدون تغییر تابستانی. این مهارت به مدل میگه تاریخ را چطور ذخیره کنه، چطور نشان بده و تعطیلی‌ها را از کجا بیاره.

    • تقویم، انتخاب تاریخ و بازه‌ی زمانی
    • گزارش و نمودار ماهانه
    • نوبت‌دهی و مهلت پرداخت
    تاریخشمسیIntl
    $npx vibefarsi add jalali-calendar
  • اعتبارسنجی ایرانیمهارتiran-validation

    الگوریتم کد ملی، شبا با mod 97، شماره کارت با Luhn و BIN بانک، موبایل ۰۹ و پلاک خودرو، همه با پذیرش اعداد فارسی و عربی. تا مدل به‌جای الگوی آمریکایی، الگوی ایرانی بنویسه.

    • فرم ثبت‌نام و احراز هویت
    • فیلد شبا، کارت و کد ملی
    • فرم آدرس و کد پستی
    فرمکد ملیشباکارت بانکی
    $npx vibefarsi add iran-validation
  • سئوی فارسیمهارتpersian-seo

    lang و hreflang درست، عنوان و توضیح کوتاه فارسی، اسلاگ‌های باثبات، نیم‌فاصله در متن و نه در آدرس، و JSON-LD با inLanguage. مثال‌ها برای Next.js نوشته شدن ولی قوانین به هر سایتی می‌خوره.

    • متادیتا و عنوان صفحه‌ها
    • ساختار URL و اسلاگ
    • JSON-LD و Open Graph
    سئومتادیتاNext.js
    $npx vibefarsi add persian-seo
  • قوانین فارسی برای CLAUDE.mdراهنماagents-md-persian

    یک بلوک آماده که داخل CLAUDE.md، AGENTS.md یا rules کرسر می‌گذارید تا هر پرامپت بعدی با فارسی، راست‌چین، اعداد فارسی و تقویم شمسی شروع بشه. خلاصه‌ی بقیه‌ی مهارت‌ها در یک صفحه.

    • شروع پروژه‌ی جدید
    • وقتی نمی‌خواید هفت تا مهارت جدا نصب کنید
    • تیم‌هایی که با چند ابزار مختلف کار می‌کنن
    راهنماCLAUDE.mdAGENTS.mdCursor
    $npx vibefarsi add agents-md-persian
  • قوانین کرافت رابطراهنماui-craft-rules

    چرا خروجی وایب‌کدینگ شبیه بقیه میشه و چطور جلوش را بگیرید: به‌جای «قشنگش کن» اسم تکنیک را بگید، به مدل اجازه‌ی مقدار دلخواه ندید، فاصله‌ی خط و اندازه‌ی فونت را محدود کنید، جای عکس را قبل از لود رزرو کنید و دکمه‌ها را ۴۴ پیکسل بزنید. همراه با یک بلوک آماده برای AGENTS.md و چک‌لیست پایان کار. init خودش این را داخل پروژه می‌نویسه.

    • شروع هر پروژه‌ای که با مدل ساخته میشه
    • وقتی خروجی مدل شبیه همه‌ی سایت‌های دیگه‌ست
    • بازبینی صفحه قبل از تحویل
    راهنماوایب‌کدینگدیزاین سیستمAGENTS.md
    $npx vibefarsi add ui-craft-rules
  • راهنمای تایپوگرافی فارسیراهنماpersian-typography

    کدام فونت رایگانه و کدام لایسنس می‌خواد، اندازه و فاصله‌ی خط برای فارسی، اعداد در جدول، متن ترکیبی فارسی و انگلیسی و نیم‌فاصله در HTML. هم برای مدل، هم برای خودتون.

    • انتخاب و لود فونت در Next.js
    • متن ترکیبی فارسی و لاتین
    • جدول‌های عددی و قیمت
    راهنمافونتنیم‌فاصله
    $npx vibefarsi add persian-typography
  • آپلود تصویر به پارس‌پکراهنماparspack-s3-upload

    آپلود سرورساید تصویر به فضای ابری پارس‌پک با AWS SDK، path-style URL، اعتبارسنجی MIME و مسیر API در Next.js App Router. آماده برای تحویل به مدل یا توسعه‌دهنده.

    • آپلود تصویر پروفایل، محصول یا گالری
    • اتصال به S3 سازگار با پارس‌پک
    • وقتی URL عمومی اشتباه ساخته میشه
    راهنماS3پارس‌پکآپلود
    $npx vibefarsi add parspack-s3-upload
  • درگاه پرداخت زرین‌پالراهنماzarinpal-payment

    پیاده‌سازی کامل زرین‌پال از request تا verify: تبدیل تومان به ریال، سند پرداخت pending، کال‌بک idempotent و چک‌لیست امنیتی. برای Next.js و هر بک‌اند Node.

    • خرید اشتراک، اعتبار یا محصول
    • اتصال درگاه بانکی ایرانی
    • کال‌بک و تأیید پرداخت
    راهنماپرداختزرین‌پالتومان
    $npx vibefarsi add zarinpal-payment
  • پیامک و OTP کاوه‌نگارراهنماkavenegar-otp

    ارسال OTP با Verify Lookup کاوه‌نگار: قالب تأییدشده، نرمال‌سازی شماره ۰۹، بررسی return.status و نمونه TypeScript آماده. کلید API فقط سمت سرور.

    • ورود با کد یک‌بارمصرف
    • تأیید شماره موبایل ایرانی
    • ارسال پیامک قالبی کاوه‌نگار
    راهنماپیامکOTPکاوه‌نگار
    $npx vibefarsi add kavenegar-otp
  • نگارش فارسیمهارت خارجیpersian-writing

    مهارت کامل نگارش فارسی از مخزن persian-writing: تشخیص لحن، حذف نشانه‌های متن ماشینی، املا و نیم‌فاصله، اسکریپت ویرایش و غلط‌گیری، و ساخت فایل Word و PDF راست‌چین. مهارت‌های نوشتاری همین صفحه از روی همین کار الهام گرفتن.

    • مقاله، پایان‌نامه و گزارش
    • ویرایش و غلط‌گیری متن موجود
    • فایل Word و PDF فارسی
    نوشتنویرایشWord و PDFسئو
    $git clone https://github.com/ali2000hos/persian-writing ~/.claude/skills/persian-writing

مهارت چیه و چطور کار می‌کنه

  • مهارت (Skill) یک پوشه با فایل SKILL.md هست. بالای فایل یک توضیح کوتاه داره که مدل با همان تصمیم می‌گیره کی این فایل را بخونه، پس لازم نیست هر بار توی پرامپت یادآوری کنید که فارسی باشه یا هفته از شنبه شروع بشه.
  • با npx vibefarsi add <slug> فایل داخل .claude/skills پروژه نوشته میشه و Claude Code همان لحظه می‌بیندش. برای Cursor و Codex همان پوشه را در مسیر مهارت‌های آن ابزار بگذارید، یا یک خط در AGENTS.md به فایل اشاره کنید. راه دقیقش در صفحه‌ی هر مهارت هست.
  • راهنماها (guide) فرانت‌متر ندارن و خودکار فعال نمیشن. آن‌ها را در docs پروژه بگذارید و از CLAUDE.md یا AGENTS.md به‌شون لینک بدید تا مدل در هر جلسه بخوندشون.
  • متن مهارت‌ها انگلیسی با مثال فارسی هست، چون مدل‌ها دستور انگلیسی را دقیق‌تر اجرا می‌کنن. فایل مال شماست؛ لحن، فونت یا قانون‌هایی که با پروژه‌تون فرق داره را همان‌جا عوض کنید.