معرفی مخزن رسمی پلاگین های Claude Code؛ اکوسیستم متن باز

مخزن رسمی و مدیریت‌شده‌ی anthropics/claude-plugins-official در گیت‌هاب، مرجعی استاندارد برای دسترسی به افزونه‌های باکیفیت و ابزارهای جانبی محیط Claude Code است. این پروژه متن‌باز به توسعه‌دهندگان اجازه می‌دهد تا قابلیت‌های ابزار هوش مصنوعی خود را با دستورات سفارشی، اسکریپت‌ها و سرورهای پروتکل متن‌باز توسعه دهند. توسعه‌دهندگانی که به ابزارهای هوش مصنوعی علاقه دارند، می‌توانند در کنار آشنایی با این مخزن، نگاهی هم به قابلیت‌های مدل‌های پیشرفته‌ی متن‌باز مانند معرفی Muse Spark Open؛ قدرتمندترین مدل هوش مصنوعی متن‌باز جهان داشته باشند تا دید وسیع‌تری نسبت به ابزارهای مدرن پیدا کنند.

ساختار مخزن و دسته‌بندی پلاگین‌ها

این مخزن به گونه‌ای سازماندهی شده است تا مدیریت پلاگین‌های داخلی و خارجی به ساده‌ترین شکل ممکن انجام گیرد. پوشه‌بندی استاندارد آن شامل بخش‌های داخلی و خارجی است که به تفکیک نگهداری می‌شوند.

هر پلاگین در این اکوسیستم ساختار مشخصی دارد تا ابزار بارگذارنده به راحتی بتواند متادیتا و اجزای آن را شناسایی کند. ساختار استاندارد یک پلاگین به شکل زیر است:

plugin-name/
├── .claude-plugin/
│   └── plugin.json      # Plugin metadata (required)
├── .mcp.json            # MCP server configuration (optional)
├── commands/            # Slash commands (optional)
├── agents/              # Agent definitions (optional)
├── skills/              # Skill definitions (optional)
└── README.md            # Documentation

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

روش نصب و راه‌اندازی افزونه‌ها

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

/plugin install {plugin-name}@claude-plugins-official

همچنین اگر ترجیح می‌دهید افزونه‌ها را به صورت بصری جستجو و انتخاب کنید، می‌توانید با استفاده از دستور زیر بخش مرورگر را باز کنید:

/plugin > Discover

نکته‌ی امنیتی بسیار مهمی که تیم توسعه‌دهنده بر آن تأکید دارد این است که پیش از نصب، به‌روزرسانی یا استفاده از هر پلاگین شخص ثالث، از اعتبار ناشر آن مطمئن شوید؛ زیرا انتروپیک کنترلی روی سرورهای MCP یا فایل‌های درون بسته‌های خارجی ندارد.

پلاگین‌های مبتنی بر بسته مهارتی (Skill-bundle)

گاهی اوقات مخزن یک پلاگین تنها شامل فایل‌های مهارتی (فایل‌های SKILL.md) است و مانیفست استاندارد .claude-plugin/plugin.json را ندارد. در چنین شرایطی، ورودی بازارچه می‌تواند این مهارت‌ها را به صورت مستقیم و با تنظیم مقدار strict: false به همراه آرایه‌ی مشخصی از مسیرها تعریف کند.

نمونه‌ی یک فایل پیکربندی برای بسته‌های مهارتی ترکیبی به صورت زیر است:

{
  "name": "example-bundle",
  "description": "Brief description of the bundled skills.",
  "author": { "name": "Author Name" },
  "category": "development",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/example-org/sdk.git",
    "path": "packages/agent-skills",
    "ref": "main",
    "sha": "<commit sha>"
  },
  "strict": false,
  "skills": [
    "./skill-a",
    "./skill-b",
    "./skill-c"
  ],
  "homepage": "https://github.com/example-org/sdk"
}

در این ساختار:

• بخش source: مشخص می‌کند مخزن گیت و زیرپوشه‌ی حاوی مهارت‌ها کجا قرار دارند.
• بخش skills: مسیرهای نسبی داخل پوشه را نشان می‌دهد که هر کدام به یک دایرکتوری حاوی فایل مهارتی ختم می‌شوند.

مدیریت تغییر نام و انتقال اسلاگ‌ها

نام‌گذاری در این اکوسیستم قوانین سخت‌گیرانه‌ای دارد. فیلد name در هر ورودی بازارچه یک اسلاگ تغییرناپذیر (Immutable Slug) محسوب می‌شود. به محض انتشار یک پلاگین، اسلاگ آن نباید تغییر کند زیرا کاربران آن را روی سیستم خود نصب کرده‌اند و تغییر نام باعث بروز خطای عدم یافتن پلاگین (plugin-not-found) می‌شود.

اگر تغییر نام یک پلاگین ضرورت پیدا کند، توسعه‌دهندگان باید نقشه‌ی تغییر نام (renames) را در فایل مانیفست بازارچه به‌روزرسانی کنند تا سیستم به‌طور خودکار نصب‌های قبلی را منتقل کند:

{
  "renames": {
    "old-name": "new-name"
  }
}

با این کار، بارگذارنده‌ی پلاگین در همگام‌سازی بعدی، اسلاگ قدیمی را به نام جدید تغییر می‌دهد.

پرسش‌های متداول

جمع‌بندی

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

مشاهده‌ی پروژه در GitHub