چی رو از CLAUDE.md به skillهای Claude Code منتقل کنیم
هوش مصنوعیخلاصهٔ کامل‌تر
نویسنده می‌گه CLAUDE.md تیم‌ها معمولاً کم‌کم بزرگ میشه: یکی چک‌لیست انتشار اضافه می‌کنه، یکی مراحل migration دیتابیس. مستندات Claude Code پیشنهاد می‌ده این فایل زیر ۲۰۰ خط بمونه، چون کلش تو هر جلسه لود میشه و فایل‌های طولانی‌تر کمتر دقیق اجرا می‌شن. راه‌حل skillه، یعنی یه مجموعه دستورالعمل که فقط وقتی لازمه لود میشه، نه همیشه.
هر skill یه پوشه‌ست با یه فایل SKILL.md که دو بخش داره: frontmatter که می‌گه skill چیکار می‌کنه و کی باید استفاده بشه، و خود دستورالعمل‌ها. اسم skill به یه دستور تبدیل میشه، مثلاً /add-migration. تا وقتی اجرا نشده، فقط توضیحش تو context هست. فایل‌های قدیمی .claude/commands/ هم هنوز کار می‌کنن، چون commandها با skillها ادغام شدن.
تست ساده‌ی نویسنده اینه: آیا ایجنت این رو تو هر جلسه لازم داره یا فقط برای یه نوع کار؟ دستورات build و test، قراردادهای کلی و معرفی محصول تو CLAUDE.md می‌مونن. چک‌لیست انتشار، مراحل migration و نحوه‌ی دیباگ یه سرویس خاص می‌رن تو skill.
جای ذخیره مهمه: .claude/skills/ تو مخزن برای کل تیم، ~/.claude/skills/ برای خودت، و تنظیمات managed برای کل سازمان. وقتی دو skill اسم یکسان دارن، enterprise به personal و personal به project اولویت داره. پس یه skill شخصی قدیمی به اسم deploy می‌تونه جای skill تیم اجرا بشه. برای همین بهتره اسم‌های خاص‌تری مثل deploy-web بذاری. تو monorepo هم هر پکیج می‌تونه skillهای خودش رو داشته باشه.
دو فیلد frontmatter تعیین می‌کنن کی می‌تونه skill رو اجرا کنه. disable-model-invocation: true یعنی فقط آدم می‌تونه اجراش کنه و Claude خودش سراغش نمی‌ره. این برای کارهای دارای عوارض جانبی مثل deploy یا انتشار لازمه، چون نمی‌خوای Claude فقط چون کد آماده به نظر می‌رسه خودش deploy کنه. user-invocable: false هم برای دانش پس‌زمینه‌ست که Claude باید بدونه ولی کسی دستی صداش نمی‌زنه.
name: release-web
description: Releases the web app to production.
disable-model-invocation: trueدو نکته‌ی دیگه: فیلد allowed-tools به skill اجازه می‌ده بدون پرسیدن از ابزارها استفاده کنه، پس تو pull requestها مثل هر تغییر دسترسی دیگه بررسیش کن. توضیح skill هم تو لیست بعد از ۱۵۳۶ کاراکتر بریده میشه، پس کاربرد اصلی رو اول بنویس و SKILL.md رو زیر ۵۰۰ خط نگه دار.
نکات کلیدی:
- مستندات Claude Code پیشنهاد می‌ده CLAUDE.md زیر ۲۰۰ خط بمونه
- skill فقط موقع نیاز لود میشه و تا اون موقع فقط توضیحش تو context هست
- اولویت skillهای هم‌نام: enterprise، بعد personal، بعد project
- برای deploy و انتشار از disable-model-invocation: true استفاده کن
- توضیح skill بعد از ۱۵۳۶ کاراکتر بریده میشه و SKILL.md بهتره زیر ۵۰۰ خط باشه
- فیلد allowed-tools تو skillهای مشترک رو مثل تغییر دسترسی بررسی کن
