diff --git a/README.ar.md b/README.ar.md index 6ae9a25..a7900f1 100644 --- a/README.ar.md +++ b/README.ar.md @@ -109,16 +109,30 @@ $$\text{محرك TidyFactor الهندسي: } \text{Brief} \longrightarrow \text --- -## 🚀 البداية السريعة (Quick Start) +## 🚀 التثبيت والبدء السريع -### 1. التثبيت عبر NPM / NPX -أضف المهارة مباشرة إلى بيئة عمل مشروعك: +اختر طريقة التثبيت المناسبة لمشروعك: + +### الخيار (أ): عبر TidyFactor CLI الرسمي (الموصى به) +التثبيت الفوري دون الحاجة لتثبيت الأداة عالمياً في بيئة عملك النشطة: +```bash +npx @tidyfactor/cli add design +``` +*أو في حال كانت الأداة مثبتة لديك عالمياً (`npm i -g @tidyfactor/cli`):* +```bash +tidyfactor add design +``` + +### الخيار (ب): عبر معيار مهارات الوكلاء المفتوح (skills.sh) +التثبيت العالمي المتوافق مع كافة بيئات الوكلاء ومحررات الذكاء الاصطناعي (Antigravity, Cursor, Claude Code, Windsurf, Codex): ```bash -# تثبيت واستدعاء المهارة في المشروع -npx @tidyfactor/design add +npx skills add tidyfactor/design +``` -# أو عبر أداة CLI الشاملة -npx @tidyfactor/cli add tidyfactor-design +### الخيار (ج): التثبيت المباشر الفردي عبر NPM +تشغيل مثبت المهارة المستقل مباشرة مع تجاوز الذاكرة المخبأة وضمان أحدث إصدار: +```bash +npx @tidyfactor/design@latest ``` ### 2. الاستدعاء المباشر في وكلاء الذكاء الاصطناعي diff --git a/README.md b/README.md index 3371325..6347b50 100644 --- a/README.md +++ b/README.md @@ -108,16 +108,30 @@ $$\text{TidyFactor Design: } \text{Design Brief} \longrightarrow \text{Rules} \l --- -## 🚀 Quick Start +## 🚀 Installation & Quick Start -### 1. Installation via NPM / NPX -Install the skill into your local project workspace: +Choose your preferred installation method: + +### Option A: Via TidyFactor CLI (Recommended) +Install directly using the official ecosystem package runner into your active workspace: +```bash +npx @tidyfactor/cli add design +``` +*Or if you have the CLI installed globally (`npm i -g @tidyfactor/cli`):* +```bash +tidyfactor add design +``` + +### Option B: Via Open Agent Skills Ecosystem (skills.sh / Vercel Labs) +Install using the universal multi-agent standard across all supported IDEs (Cursor, Antigravity, Claude Code, Windsurf, Trae, Codex): ```bash -# Add to current workspace -npx @tidyfactor/design add +npx skills add tidyfactor/design +``` -# Or run the global CLI runner -npx @tidyfactor/cli add tidyfactor-design +### Option C: Standalone Zero-Dependency Runner (NPM Direct) +Run the dedicated skill installer directly with automatic cache invalidation: +```bash +npx @tidyfactor/design@latest ``` ### 2. Invocable in All Major AI Coding Agents