إنشاء مواصفات OpenAPI
تحتاج فرق API إلى عقود دقيقة للتوثيق والتحقق وإنشاء SDK. توفر هذه المهارة أنماط OpenAPI 3.1 وقوالبه وإرشادات الأدوات الخاصة به.
انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.
Review the Skillstore skill "openapi-spec-generation" from https://skillstore.io/skills/wshobson-openapi-spec-generation.md and its manifest at https://skillstore.io/api/skills/wshobson-openapi-spec-generation/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.
استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.
جارٍ استخدام "openapi-spec-generation". طلب لتوثيق API لإدارة المستخدمين.
النتيجة المتوقعة:
جارٍ استخدام "openapi-spec-generation". طلب لتحضير مواصفة لإنشاء SDK.
النتيجة المتوقعة:
جارٍ استخدام "openapi-spec-generation". طلب لتحسين عقد API موجود.
النتيجة المتوقعة:
The flagged patterns are false positives from Markdown code fences, sample OpenAPI URLs, resource links, UUID schema examples, and generic error responses. No prompt injection, hidden command execution, credential access, or data exfiltration intent was found in SKILL.md.
شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.
https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/wshobson-openapi-spec-generation?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/wshobson-openapi-spec-generation?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/wshobson-openapi-spec-generation/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/wshobson-openapi-spec-generation.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>wshobson. (2026). openapi-spec-generation security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8@techreport{wshobson-wshobson-openapi-spec-generation-2026,
author = {wshobson},
title = {openapi-spec-generation security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "openapi-spec-generation security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "wshobson"
date-released: "2026-07-08"
url: "https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8"
identifiers:
- type: other
value: "skillstore:wshobson-openapi-spec-generation:audit:8"
description: "Skillstore immutable audit report identifier"
تبقى مهارة كل مؤلف عنصراً مستقلاً قابلاً للتثبيت. يُرتب المتغير الموصى به وفق أدلة Skillstore.
سبب تصدر هذا المتغير
sickn33-openapi-spec-generation
2026-09-09
wshobson-openapi-spec-generation
2026-09-09
صياغة مواصفة OpenAPI 3.1 قبل التنفيذ، بما في ذلك paths وrequest bodies والأخطاء والمصادقة.
تحويل أنماط وحدات تحكم FastAPI أو TypeScript إلى مواصفة OpenAPI متسقة للمستهلكين الداخليين والخارجيين.
التحقق من ملف OpenAPI وتجميعه وهيكلته قبل إنتاج مكتبات عملاء للغات متعددة.
أنشئ مسودة OpenAPI 3.1 لواجهة API بسيطة تعتمد على مورد. قم بتضمين paths وschemas وأمثلة وأخطاء ومصادقة bearer.
راجع ملف OpenAPI هذا بحثًا عن operation IDs المفقودة، وتغطية responses غير المكتملة، وإعادة استخدام schemas، والأوصاف غير الواضحة.
استخدم كود FastAPI أو tsoa هذا لتصميم عقد OpenAPI المطابق. أبرز الفجوات بين التنفيذ والسلوك الموثق.
صمم تدفق عمل للتحقق من مواصفة OpenAPI هذه باستخدام الفحص، والتجميع، وفحوصات التغييرات الكاسرة، وجاهزية إنشاء SDK.
المؤلف
wshobsonالترخيص
MIT
مراجعة Skillstore
r1
تنبيه الإصدار
لم يعلن المؤلف عن إصدار.
مرجع
64ca8af0f54a325752f08bd54e52151061ea659a
حداثة الصيانة
٢٢/٧/٢٠٢٦
الاستخدام
12 تنزيلات · 242 مشاهدات
بنية الملفات
📄 SKILL.md
تحسين مطالبات LLM للإنتاج
غالبًا ما تفشل مطالبات LLM لأن التعليمات والأمثلة ومعايير التقييم تكون غير واضحة. توفر هذه المهارة قوالب وسير عمل لتحسين المطالبات في Claude وCodex وClaude Code والأدوات المشابهة.
إدارة التطوير المعتمد على السياق
تفقد المشاريع المدعومة بالذكاء الاصطناعي اتساقها عندما تكون أهداف المنتج، وخيارات الحزمة التقنية، وقواعد سير العمل مبعثرة. ترشد هذه المهارة Claude وCodex وClaude Code عبر عناصر سياق Conductor.
بناء نماذج مالية للشركات الناشئة
تحتاج فرق الشركات الناشئة إلى توقعات واضحة قبل أن تتمكن من تخطيط التوظيف وجمع التمويل واستخدام النقد. تنظم هذه المهارة الإيرادات والتكاليف ومدى كفاية النقد والسيناريوهات في مخرجات عملية للتخطيط المالي.
تصميم لوحات مؤشرات أداء رئيسية تقود القرارات
غالبا ما تبني الفرق لوحات معلومات تعرض الكثير من الأرقام لكنها لا توجه إلى اتخاذ إجراء. تساعد هذه المهارة Claude وCodex وClaude Code على اختيار مؤشرات أداء رئيسية ذات معنى، وتنظيم طرق العرض، وعرض المقاييس بوضوح.
كتابة تقارير ما بعد الحوادث بلا لوم
غالبا ما تصبح مراجعات الحوادث غير متسقة، أو مركزة على اللوم، أو صعبة التنفيذ. تساعد هذه المهارة Claude وCodex وClaude Code على صياغة تقارير منظمة لما بعد الحوادث مع جداول زمنية واضحة، وأسباب جذرية، ومالكين محددين.
بناء قصص بيانات واضحة
غالبا ما تفشل المقاييس الخام في إقناع أصحاب المصلحة أو دعم القرارات. تساعد هذه المهارة Claude وCodex وClaude Code على تحويل التحليل إلى سرديات واضحة ومرئيات وتوصيات.
إنشاء توثيق API واضح
بواسطة supercent-io
تحتاج فرق API إلى توثيق دقيق يشرح نقاط النهاية والمخططات والمصادقة والأخطاء. تحوّل هذه المهارة تفاصيل API إلى مراجع وأدلة منظّمة.
إنشاء توثيق واضح لواجهات API
بواسطة sickn33
غالبا ما تفقد فرق API وقتا عندما يكون سلوك نقاط النهاية غير واضح. تحول هذه المهارة التعليمات البرمجية والأمثلة إلى توثيق منظم وملائم للمطورين.
إنشاء توثيق API دقيق
بواسطة sickn33
تفقد فرق API الوقت عندما تنحرف المواصفات والأمثلة والبوابات عن السلوك الفعلي. توجّه هذه المهارة Claude وCodex وClaude Code خلال إنشاء توثيق API دقيق وقابل للصيانة.
إنشاء توثيق API
بواسطة zhangchenlai-dev
غالبا ما يتأخر توثيق API اليدوي عن الكود ويسبب ارتباكا للمطورين. تساعد هذه المهارة في إنتاج مسودات OpenAPI، وأمثلة الطلبات، وإرشادات مجموعات Postman من الكود المتاح أو تفاصيل نقاط النهاية.
إنشاء توثيق برمجي قابل للصيانة
بواسطة sickn33
غالبًا ما يتأخر التوثيق اليدوي عن الكود النشط. تساعد هذه المهارة Claude وCodex وClaude Code على إنشاء توثيق واضح وخطط أتمتة.
إنشاء توثيق تقني كامل
بواسطة 89jobrien
تحتاج الفرق التقنية إلى توثيق واضح عبر APIs والإصدارات وعمليات الترحيل. تنشئ هذه المهارة توثيقًا منظّمًا باستخدام قوالب وأمثلة عملية.