claude-kit کے ساتھ Claude Code کا زیادہ مؤثر ورک فلو بنائیں

claude-kit کیا فراہم کرتا ہے

claude-kit Claude Code کے لیے خودمختار skills، agents اور mods کا مجموعہ ہے۔ ہر آئٹم repository کی plugins/ ڈائریکٹری میں موجود ہے، اس لیے آپ صرف اپنی ضرورت کی functionality انسٹال کر سکتے ہیں۔

• savvy-flow: یہ skill اور agent package سیشن کو task کی منصوبہ بندی کرنے، tiered worker subagents کو کام سونپنے اور ان کے نتائج کا جائزہ لینے کی سہولت دیتا ہے۔ دستی طور پر انسٹال ہونے پر اسے /savvy-flow سے، یا marketplace کے ذریعے انسٹال ہونے پر اس کے plugin namespace کے ساتھ چلایا جاتا ہے۔
• savvy-progress: یہ mod prompt کے اوپر progress bar اور live agents panel شامل کرتا ہے۔ اسے savvy-flow کے لیے بنایا گیا ہے، لیکن یہ کسی بھی subagents کو بھی دکھا سکتا ہے۔

دونوں plugins آزادانہ طور پر کام کرتے ہیں۔ جب دونوں انسٹال ہوں تو savvy-flow progress bar کو چلاتا ہے، جبکہ اس کے workers اپنی پیش رفت agents panel میں رپورٹ کرتے ہیں۔

marketplace سے claude-kit انسٹال کریں

Claude Code میں plugins انسٹال کرنے کا marketplace طریقہ سب سے آسان ہے۔

1. Claude Code کھولیں۔
2. Repository کو marketplace کے طور پر شامل کریں اور مطلوبہ plugins انسٹال کریں:

/plugin marketplace add johnnyvizz/claude-kit
/plugin install savvy-flow@claude-kit
/plugin install savvy-progress@claude-kit

انسٹالیشن کے بعد سیشن restart کریں۔ Marketplace سے انسٹال کیے گئے skills اور agents کے ساتھ namespace شامل ہوتا ہے۔ لہٰذا savvy-flow skill کو /savvy-flow:savvy-flow کے طور پر چلایا جاتا ہے، اور اس کے agents کے نام savvy-flow:savvy-careful جیسے ہوتے ہیں۔

اگر آپ کے workflow کے لیے بہتر ہو تو صرف ایک plugin انسٹال کر سکتے ہیں۔ جب آپ planning workflow اور visual progress indicators کو ساتھ استعمال کرنا چاہیں تو دونوں انسٹال کریں۔

Components دستی طور پر انسٹال کریں

دستی انسٹالیشن اس وقت مفید ہے جب آپ کسی skill کو اپنی Claude Code configuration میں copy کرنا یا کسی mod کو local checkout سے براہِ راست load کرنا چاہتے ہوں۔

Repository clone کریں

git clone https://github.com/johnnyvizz/claude-kit.git ~/claude-kit

savvy-flow skill اور agents copy کریں

اس طریقے سے انسٹال کرنے پر skill کو plugin system کی ضرورت نہیں ہوتی۔ Skill folder کو اپنی Claude Code skills directory میں copy کریں:

cp -R ~/claude-kit/plugins/savvy-flow/skills/savvy-flow ~/.claude/skills/

پھر فراہم کردہ agent definitions کو agents directory میں copy کریں:

cp ~/claude-kit/plugins/savvy-flow/agents/*.md ~/.claude/agents/

اس طریقے میں نام مختصر رہتے ہیں: skill کے لیے /savvy-flow اور agents کے لیے savvy-careful جیسے نام استعمال کریں۔

ایک سیشن کے لیے savvy-progress load کریں

صرف کسی مخصوص Claude Code سیشن کے لیے progress mod load کرنے کے لیے Claude Code کو اس کے plugin directory کے ساتھ شروع کریں:

claude --plugin-dir ~/claude-kit/plugins/savvy-progress

ہر سیشن کے لیے savvy-progress load کریں

Mod کو desktop app سمیت ہر سیشن کے لیے دستیاب بنانے کے لیے ~/.claude/settings.json میں CLAUDE_CODE_PLUGIN_DIRS configure کریں:

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-kit/plugins/savvy-progress"
  }
}

اگر آپ متعدد plugin folders configure کرتے ہیں تو انہیں : سے الگ کریں۔ اگر CLAUDE_CODE_PLUGIN_DIRS میں پہلے سے کوئی value موجود ہو تو موجودہ entries کو replace کرنے کے بجائے نیا folder ان کے آخر میں شامل کریں۔

بنیادی workflow چلائیں

savvy-flow انسٹال کرنے کے بعد اسے منصوبہ بندی اور coordination کے لیے کوئی task دیں۔ مثال کے طور پر، manually copied skill کے ساتھ:

/savvy-flow review the authentication changes and identify missing tests

Marketplace installation کے ساتھ namespaced form استعمال کریں:

/savvy-flow:savvy-flow review the authentication changes and identify missing tests

Session model کام کی منصوبہ بندی کرتا ہے، اپنے worker subagents کو tasks سونپتا ہے اور ان کے output کا جائزہ لیتا ہے۔ اگر savvy-progress بھی active ہو تو progress bar اور agents panel اس activity کا live view فراہم کرتے ہیں۔

درست task آپ کے اختیار میں ہے: ایسا code review، investigation یا development task دیں جسے planning اور delegated work سے فائدہ ہو۔

Repository layout سمجھیں

ہر plugin ایک قابلِ پیش گوئی structure کی پیروی کرتا ہے۔ Marketplace catalog اور plugin manifests یہ طے کرتے ہیں کہ Claude Code components کو کیسے دریافت کرتا ہے:

.claude-plugin/marketplace.json   وہ catalog جسے `/plugin marketplace add` پڑھتا ہے
plugins/<name>/
  .claude-plugin/plugin.json      manifest
  skills/<skill>/SKILL.md         ایک skill
  agents/*.md                     فراہم کردہ subagents
  hooks/hooks.json                ایک mod: hooks module کی طرف اشارہ
  hooks/register.tsx              ایک mod: خود module
  types/index.d.ts                ایک mod: اس کا $.state contract

اس layout میں skill کو SKILL.md file بیان کرتی ہے اور وہ agent definitions فراہم کر سکتی ہے۔ Mod میں hook configuration اور registration module ہوتا ہے؛ اس کی type declaration $.state contract کو document کرتی ہے۔

Publish کرنے سے پہلے plugins validate کریں

کسی ایک plugin یا marketplace catalog کو check کرنے کے لیے Claude Code کے validation commands استعمال کریں:

claude plugin validate plugins/<name>
claude plugin validate .

پہلا command plugin directory کو validate کرتا ہے۔ دوسرا repository کے root سے catalog کو validate کرتا ہے۔

Manual installations کو تازہ رکھیں

جب آپ cloned repository سے براہِ راست mod load کریں تو اسے اس command سے update کریں:

cd ~/claude-kit
git pull

اس ڈائریکٹری سے لوڈ کیا گیا موڈ تازہ ترین فائلیں استعمال کرتا ہے۔ ~/.claude/skills/ میں کاپی کی گئی اسکلز خودکار طور پر اپ ڈیٹ نہیں ہوتیں؛ نئی تبدیلیاں حاصل کرنے کے بعد اسکل اور ایجنٹ فائلیں دوبارہ کاپی کریں۔

اعلیٰ درجے کے غور طلب نکات

نام کی جگہ والے یا مختصر کمانڈز کا انتخاب سوچ سمجھ کر کریں

مارکیٹ پلیس سے انسٹالیشن /savvy-flow:savvy-flow جیسے نام کی جگہ والے ناموں کے ذریعے پلگ اِن کو الگ رکھتی ہے۔ دستی اسکل انسٹالیشن پلگ اِن سسٹم سے گریز کرتی ہے اور کمانڈز مختصر رکھتی ہے۔ وہ طریقہ استعمال کریں جو اس بات کے مطابق ہو کہ آپ مارکیٹ پلیس مینجمنٹ کو ترجیح دیتے ہیں یا براہِ راست مقامی فائلوں کو۔

موڈ کی مطابقت کو مدِنظر رکھیں

موڈز hooks/register.tsx کے ذریعے فنکشن ہُکس استعمال کرتے ہیں، جو Claude Code کی ابتدائی رسائی والی API ہے۔ ریپوزٹری کا تجربہ Claude Code 2.1.286 پر کیا گیا تھا، اور ریلیزز کے درمیان API تبدیل ہو سکتی ہے۔

اگر مارکیٹ پلیس سے انسٹال کیا گیا موڈ نظر نہ آئے تو اسے --plugin-dir کے ذریعے دستی طور پر لوڈ کریں یا اس کے فولڈر کو CLAUDE_CODE_PLUGIN_DIRS کے ذریعے ترتیب دیں۔

جب آپ کو مرئیت درکار ہو تو پلگ اِنز کو یکجا کریں

savvy-flow، savvy-progress کے بغیر کام کر سکتا ہے، اور savvy-progress بھی savvy-flow کے بغیر کام کر سکتا ہے۔ دونوں کو انسٹال کرنا سب سے زیادہ معلوماتی سیٹ اپ ہے: ورک فلو کام کو مربوط کرتا ہے جبکہ موڈ پیش رفت اور فعال ایجنٹ کی حالت ظاہر کرتا ہے۔

نتیجہ

claude-kit، Claude Code صارفین کو ماڈیولر منصوبہ بندی، تفویض، جائزے اور پیش رفت کی نگرانی کے ٹولز فراہم کرتا ہے۔ منظم سیٹ اپ کے لیے مارکیٹ پلیس سے savvy-flow اور savvy-progress انسٹال کریں، یا ریپوزٹری کلون کرکے اجزا دستی طور پر کاپی یا لوڈ کریں۔ نام کی جگہ کے فرق کو یاد رکھیں، شائع کرنے سے پہلے تبدیلیوں کی توثیق کریں، اور ریپوزٹری سے لوڈ کیے گئے موڈز سے الگ کاپی کی گئی اسکلز کو اپ ڈیٹ کریں۔