پرش به محتوای اصلی
شروع کار

ساخت اولین اسکیل اختصاصی با SKILL.md

از ساختن پوشه تا نوشتن SKILL.md، افزودن اسکریپت و آپلود در Claude؛ یک اسکیل واقعی برای نوشتن مقاله‌ی فارسی سئو شده را قدم به قدم می‌سازیم.

  • سطح: متوسط
  • ۵ گام
  • ۲ دقیقه مطالعه
  • به روزرسانی ۲۵ مهر ۱۴۰۵
SKILL.mdساخت اسکیلCustom Skills
در این صفحه (۵ گام)
  1. ۱.پوشه‌ی اسکیل را بساز
  2. ۲.فایل SKILL.md را بنویس
  3. ۳.یک اسکریپت کمکی اضافه کن
  4. ۴.اسکیل را امتحان کن
  5. ۵.در اپ Claude آپلودش کن

در این آموزش یک اسکیل کامل به اسم persian-seo-writer می‌سازیم که به Claude یاد می‌دهد مقاله‌ی فارسی را با قواعد سئوی ما بنویسد. همین الگو برای هر کار تکراری دیگری هم جواب می‌دهد.

  1. گام ۱: پوشه‌ی اسکیل را بساز

    یک پوشه بساز که اسمش همان اسم اسکیل است. اسم فقط می‌تواند حروف کوچک انگلیسی، عدد و خط تیره داشته باشد و حداکثر ۶۴ نویسه است.

    terminal
    mkdir -p persian-seo-writer/scriptscd persian-seo-writer

  2. گام ۲: فایل SKILL.md را بنویس

    بالای فایل، بین دو خط ---، فراداده می‌آید و بعد دستورالعمل به زبان ساده. این فایل را می‌توانی همین جا کپی یا دانلود کنی:

    SKILL.md
    ---name: persian-seo-writerdescription: Writes and edits Persian blog posts with Looms' SEO rules. Use when the user asks for a Persian article, blog post, meta description or SEO title.--- # Persian SEO writer ## Instructions1. Ask for the target keyword if it is missing.2. Keep paragraphs under 60 words; use H2 for main sections.3. Put the keyword in the first paragraph and one H2.4. Write the meta description between 120 and 155 characters.5. Run `scripts/check_length.py` on the draft and fix anything it reports. ## Examples- "یک مقاله درباره پرامپت نویسی برای عکس پرتره بنویس"- "برای این متن عنوان سئو و توضیحات متا بنویس"

  3. گام ۳: یک اسکریپت کمکی اضافه کن

    کارهایی که جواب قطعی دارند (شمردن، تبدیل، اعتبارسنجی) را به اسکریپت بسپار. Claude اسکریپت را اجرا می‌کند و فقط نتیجه را می‌بیند:

    scripts/check_length.py
    import sys text = sys.stdin.read()for number, paragraph in enumerate(text.split("\n\n"), start=1):    words = len(paragraph.split())    if words > 60:        print(f"paragraph {number}: {words} words (max 60)")

  4. گام ۴: اسکیل را امتحان کن

    اول در Claude Code امتحانش کن؛ ساده ترین راه است. پوشه را در مسیر اسکیل های شخصی کپی کن و یک گفتگوی تازه شروع کن:

    terminal
    cp -r persian-seo-writer ~/.claude/skills/

    حالا درخواستی بده که با description جور باشد، مثلا «یک مقاله درباره پرامپت پرتره بنویس». اگر اسکیل فعال نشد، معمولا مشکل از توضیح است: کلمه هایی که کاربر واقعا می‌گوید را در آن بیاور.

  5. گام ۵: در اپ Claude آپلودش کن

    1. از پوشه یک فایل zip بساز؛ خود پوشه باید داخل zip باشد، نه فقط محتوایش
    2. در Claude به Settings ← Capabilities برو، «Code execution and file creation» را روشن کن و به بخش Skills برو
    3. فایل zip را آپلود کن و اسکیل را روشن کن
    terminal
    zip -r persian-seo-writer.zip persian-seo-writer