SKILL.md ফরম্যাট ও ফ্রন্টম্যাটার ভ্যালিডেটর

Agent Skills কাঠামোর মূল ভিত্তি হলো একটি নির্দিষ্ট ফোল্ডার এবং তার ভেতরের SKILL.md ফাইল। এই ফাইলটির মাধ্যমে বিভিন্ন কৃত্রিম বুদ্ধিমত্তা চালিত এজেন্টকে নতুন কোনো কাজের সুনির্দিষ্ট নির্দেশিকা বা দক্ষতা শেখানো যায়। ফাইলটির গঠন মূলত দুই ভাগে বিভক্ত। সবার উপরে থাকে YAML ফরম্যাটে লেখা ফ্রন্টম্যাটার এবং নিচের অংশে থাকে বিস্তারিত নির্দেশনাবলী যা সাধারণ Markdown ফরম্যাটে সাজানো হয়। যখন কোনো AI এজেন্ট কোনো প্রজেক্ট বা রিপোজিটরি লোড করে, তখন সে শুরুতেই সম্পূর্ণ ফাইলের ভেতরের তথ্য পড়ে না। এজেন্ট শুধু ফ্রন্টম্যাটারের নাম এবং বিবরণ পড়ে জেনে নেয় দক্ষতাটি কী কাজে লাগে। যখন কোনো নির্দিষ্ট কাজ সম্পাদন করার জন্য এই দক্ষতার প্রয়োজন হয়, তখন এজেন্ট ফাইলের মূল বডি অংশ লোড করে নির্দেশ অনুযায়ী কাজ সম্পন্ন করে। আপনি যদি ফ্রন্টম্যাটারের গঠন সঠিকভাবে সাজাতে চান, তবে YAML ডেটা বিন্যাস যাচাই করে নেওয়া বেশ সহায়ক হতে পারে। SKILL.md ভ্যালিডেটর ব্যবহারের মাধ্যমে নিশ্চিত হওয়া যায় যে ফাইলটির গঠন স্পেসিফিকেশন অনুযায়ী ত্রুটিমুক্ত রয়েছে।

Agent Skills স্ট্যান্ডার্ড বজায় রাখার জন্য ফ্রন্টম্যাটারের প্রতিটি ফিল্ডের জন্য নির্দিষ্ট নিয়ম মানতে হয়। যদি ফ্রন্টম্যাটার শুরু বা শেষ করার সঠিক সিনট্যাক্স না থাকে, তবে এজেন্ট ফাইলটি চিনতে ব্যর্থ হয়। ফ্রন্টম্যাটারের প্রধান ফিল্ডগুলোর সীমা এবং শর্তাবলী নিচে উল্লেখ করা হলো:

ফাইলের নাম অবশ্যই ফোল্ডারের নামের সাথে মিলতে হবে। ফ্রন্টম্যাটার স্ট্রাকচার তৈরি করার সময় ডেটা কনভার্ট করতে JSON থেকে ডেটা রূপান্তর পদ্ধতি ব্যবহার করা যায়। কোনো ফিল্ডে অতিরিক্ত ক্যারেক্টার থাকলে ভ্যালিডেটর সেটিকে তাৎক্ষণিক ত্রুটি হিসেবে চিহ্নিত করে।

একটি স্কিল স্বয়ংক্রিয়ভাবে সক্রিয় হবে কি না, তা সম্পূর্ণ নির্ভর করে ফ্রন্টম্যাটারের description ফিল্ডের মানের উপর। এজেন্ট প্রতিবার সিদ্ধান্ত নেওয়ার সময় দেখে যে ব্যবহারকারীর প্রম্পটের সাথে ডেসক্রিপশনের নির্দেশনা মিলছে কি না। ডেসক্রিপশনে কেবল স্কিলটি কী করে তা লিখলে অনেক সময় এজেন্ট বুঝতে পারে না এটি কখন কল করা উচিত। এজন্য ডেসক্রিপশনের ভেতর কখন এই স্কিলটি ব্যবহার করতে হবে তা স্পষ্ট ভাষায় লিখে দেওয়া জরুরি। যদি ডেসক্রিপশন ৬০ ক্যারেক্টারের কম হয়, তবে ভ্যালিডেটর সতর্কবার্তা প্রদান করে। একটি দুর্বল ডেসক্রিপশনের উদাহরণ হলো 'React কম্পোনেন্ট তৈরি করে'। অন্যদিকে একটি শক্তিশালী ডেসক্রিপশন হতে পারে 'নতুন React বা Next.js কম্পোনেন্ট তৈরি ও টেস্টিংয়ের প্রয়োজন হলে এটি ব্যবহার করুন'। স্পষ্ট এবং শর্তযুক্ত ডেসক্রিপশন লিখলে এজেন্টের কাজ অনেক বেশি নির্ভুল হয় এবং স্কিলটি নিখুঁতভাবে সক্রিয় হয়।

SKILL.md ফাইলের ভেতরের Markdown অংশের সাইজ নিয়ন্ত্রণে রাখা অত্যন্ত জরুরি। স্পেসিফিকেশনের পরামর্শ অনুযায়ী একটি স্কিল ফাইলের বডি ৫০০ লাইনের মধ্যে রাখা উচিত। আনুমানিক টোকেন সংখ্যা ৫,০০০ এর নিচে রাখা ভালো, যেখানে প্রতি ৪ ক্যারেক্টারকে একটি আনুমানিক টোকেন ধরা হয়। মূল বডিতে কমপক্ষে ২০ টি শব্দ থাকা প্রয়োজন। নির্দেশিকা খুব দীর্ঘ হয়ে গেলে বড় অংশগুলোকে references/ ফোল্ডারের ভেতর আলাদা ফাইল হিসেবে রাখা উচিত এবং মূল ফাইল থেকে সেগুলোর আপেক্ষিক লিংক দেওয়া নিয়মসম্মত। নির্দেশনার ভেতর কোনো পরম পাথ বা খুব গভীর নেস্টেড লিঙ্ক ব্যবহার করা উচিত নয়। ফাইলে কোনো খসড়া টেক্সট যেমন TODO বা Lorem Ipsum থাকলে তা এজেন্টের আচরণে বিভ্রান্তি সৃষ্টি করতে পারে, তাই ভ্যালিডেটর এমন টেক্সট পেলে সতর্কতা প্রদর্শন করে।

একটি স্কিল একাধিক এজেন্টের সাথে যেন কাজ করতে পারে, সেজন্য স্পেসিফিকেশনের মানদণ্ড এবং প্ল্যাটফর্ম-নির্দিষ্ট সুবিধার পার্থক্য জানা দরকার। স্ট্যান্ডার্ড Agent Skills স্পেসিফিকেশনে name, description, compatibility এবং license এর মতো ফিল্ডগুলোকে সাধারণ ভিত্তি হিসেবে ধরা হয়েছে। অন্যদিকে Claude Code এর মতো প্ল্যাটফর্ম অতিরিক্ত কিছু ফিল্ড যেমন model, hooks সমর্থন করে। এই ফিল্ডগুলো Claude Code ছাড়া অন্য প্ল্যাটফর্মে কোনো প্রভাব ফেলে না, তাই ভ্যালিডেটর এগুলোতে ত্রুটি না দেখিয়ে নোট হিসেবে প্রদর্শন করে। যেকোনো অনিবন্ধিত বা অতিরিক্ত কাস্টম তথ্য সবসময় metadata ফিল্ডের ভেতরে রাখা উচিত। এছাড়া allowed-tools ফিল্ডটি এখনও পরীক্ষামূলক এবং এটি YAML লিস্টের বদলে স্পেস দিয়ে আলাদা করা স্ট্রিং হিসেবে লেখা সঠিক নিয়ম। নিরাপদ অটোমেশন নিশ্চিত করতে অন্যান্য সুরক্ষিত চাবি যেমন অনুমোদন চাবি তৈরি প্রক্রিয়াও কাজে লাগানো যেতে পারে।

SKILL.md ভ্যালিডেটর ফাইল পরীক্ষা করে তিনটি স্তরে ফলাফল প্রদর্শন করে। লাল রঙের ত্রুটি বা Error থাকলে ফাইলটি স্পেসিফিকেশন ভঙ্গ করেছে এবং কোনো এজেন্ট এটি ব্যবহার করতে পারবে না। হলুদ রঙের সতর্কতা বা Warning নির্দেশ করে যে ফাইলের গঠন কিছুটা দুর্বল, যেমন অতি সংক্ষিপ্ত ডেসক্রিপশন বা বড় সাইজের বডি। নীল রঙের নোট বা Note কেবল প্ল্যাটফর্ম-নির্দিষ্ট তথ্য তুলে ধরে। কোনো ফাইলে শূন্য ত্রুটি থাকলে সেটিকে বৈধ হিসেবে ধরা হয়। রিপোর্ট থেকে সহজেই CSV বা ছবি হিসেবে ফলাফল সংগ্রহ করা যায়। এই টুলটি ব্রাউজারের ভেতরে সরাসরি ক্লায়েন্ট-সাইডে কাজ করে। ফলে আপনার কোনো কোড, গোপন ইন্টারনাল ওয়ার্কফ্লো বা নির্দেশনা কোনো সার্ভারে আপলোড হয় না। এটি কেবল লেখার ফরম্যাট এবং কাঠামোগত নিয়ম পরীক্ষা করে, কিন্তু ফাইলের ভেতরের লিংকের অস্তিত্ব বা নির্দেশনার গুণগত মান যাচাই করে না।