درس ۷ از ۲۲

کار با Skills

عنوان اصلی: Working with Skills

هدف یادگیری: استفاده از Skills از پیش ساخته‌شده‌ی Anthropic و ساختن Skills سفارشی خودتان.

مفاهیم کلیدی: Skill, SKILL.md, YAML frontmatter (name, description), progressive disclosure, code execution, Customize > Skills, Anthropic Skills, Personal Skills, Shared Skills, Partner Skills

یک Skill پوشه‌ای از instructions، script ها و resource است که Claude به‌صورت پویا، فقط در زمان مرتبط بودن، load می‌کند. Skills به Claude یاد می‌دهند یک کار خاص را تکرارپذیر انجام دهد — اعمال brand guidelines، گزارش template دار هفتگی، باز کردن JIRA ticket، ساخت Excel با فرمول صحیح. Claude از progressive disclosure استفاده می‌کند: فقط description همه‌ی Skills نصب‌شده را scan می‌کند و محتوای کامل فقط آن‌هایی را که مرتبط‌اند load می‌کند، تا context پر نشود.

Skills چهار نوع دارند: Anthropic Skills (Excel، Word، PowerPoint، PDF — Claude خودکار استفاده می‌کند)، Personal Skills (سفارشی شما)، Shared Skills (به اشتراک گذاشته‌شده‌ی همکاران)، و Partner Skills (Notion، Figma، Atlassian و غیره).

یک Skill در حداقلی‌ترین شکل، پوشه‌ای حاوی SKILL.md است. این فایل با YAML frontmatter شروع می‌شود — name (≤۶۴ کاراکتر) و description (≤۲۰۰ کاراکتر؛ همان چیزی که Claude برای match کردن با prompt شما scan می‌کند). متادیتای اختیاری شامل dependencies است. بدنه Markdown ساده است: Overview، instructions و «When to Apply». Skills می‌توانند script های Python یا Node ضمیمه داشته باشند که در sandbox Claude اجرا می‌شوند.

مثال عملی — فعال‌سازی Skill داخلی

  1. به Settings > Capabilities (Free / Pro / Max) یا Organization settings > Skills (Team / Enterprise) بروید و Code execution and file creation را روشن کنید (Team / Enterprise باید Skills هم روشن شود).
  2. به Customize > Skills بروید و Anthropic Skills (Excel، Word، PowerPoint، PDF) را فعال کنید.
  3. بپرسید: «یک PowerPoint deck درباره‌ی نتایج Q3 با ۴ شاخص کلیدی بساز.» Claude خودکار Skill را invoke می‌کند و .pptx تحویل می‌دهد.

مثال عملی — آپلود Skill سفارشی

  1. یک پوشه‌ی brand-guidelines/ با SKILL.md بسازید:
---
name: Brand Guidelines
description: Apply Acme Corp brand standards to all presentations, documents, and visuals.
---
### Overview
This skill enforces Acme Corp brand rules.
### Sections
- Primary color: #003366
- Logo placement: top-left, 32px margin
- Approved fonts: Vazirmatn, Inter
### When to Apply
Use this skill any time the user asks for a presentation, doc, or visual for Acme Corp.
  1. zip کنید (brand-guidelines.zip → brand-guidelines/ → SKILL.md — پوشه در root).
  2. Customize > Skills > + را بزنید.
  3. Upload a skill و zip را انتخاب کنید.
  4. Skill جدید را روشن کنید.
  5. تست: «یک ۵-اسلایدی درباره‌ی برد Q3 ما برای Acme Corp بساز.»

اشتباهات رایج

  • description ضعیف — مثل یک آگهی استخدام یک‌خطی بنویسید.
  • یک «mega-Skill» — چند Skill کوچک بسازید؛ Claude خودش compose می‌کند.
  • hardcode کردن credential در script — از connectors استفاده کنید.
  • ندادن prompt واقعی برای تست — ۳ تا ۵ prompt قبل از rollout.