Design Stable APIs and Interfaces
Unclear contracts, inconsistent errors, and unsafe retries make APIs difficult to use and evolve. This skill provides practical patterns for typed interfaces, validation boundaries, compatibility, pagination, and idempotency.
انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.
Review the Skillstore skill "api-and-interface-design" from https://skillstore.io/skills/addyosmani-api-and-interface-design.md and its manifest at https://skillstore.io/api/skills/addyosmani-api-and-interface-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.
استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.
جارٍ استخدام "api-and-interface-design". Create a contract for a task service with create, list, update, and delete operations.
النتيجة المتوقعة:
جارٍ استخدام "api-and-interface-design". Review a charge endpoint that checks for an idempotency key, charges a card, then stores the key.
النتيجة المتوقعة:
The sequence has a race because concurrent requests can both pass the check. Claim the key with a unique constraint before the charge, compare request hashes, and define a deliberate response for in-flight duplicates.
جارٍ استخدام "api-and-interface-design". Plan a compatible addition of an optional priority field to task creation.
النتيجة المتوقعة:
Add the optional field without changing existing types or removing fields. Document the default, validate it at the API boundary, update shared types, and add contract tests for old clients.
All 52 static findings are false positives from Markdown backticks, TypeScript template literals, REST examples, and ordinary API terminology. The skill is documentation-only and contains no shell execution, system reconnaissance, prompt injection, or malicious intent.
شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.
https://skillstore.io/skills/addyosmani-api-and-interface-design/audits/2?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/addyosmani-api-and-interface-design?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/addyosmani-api-and-interface-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/addyosmani-api-and-interface-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/addyosmani-api-and-interface-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>addyosmani. (2026). api-and-interface-design security audit report (audit version 2) [Author version unspecified]. Skillstore. https://skillstore.io/skills/addyosmani-api-and-interface-design/audits/2@techreport{addyosmani-addyosmani-api-and-interface-design-2026,
author = {addyosmani},
title = {api-and-interface-design security audit report (audit version 2)},
institution = {Skillstore},
year = {2026},
number = {2},
url = {https://skillstore.io/skills/addyosmani-api-and-interface-design/audits/2},
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: "api-and-interface-design security audit report (audit version 2)"
version: "unspecified"
type: report
authors:
- name: "addyosmani"
date-released: "2026-09-19"
url: "https://skillstore.io/skills/addyosmani-api-and-interface-design/audits/2"
identifiers:
- type: other
value: "skillstore:addyosmani-api-and-interface-design:audit:2"
description: "Skillstore immutable audit report identifier"
Define resource URLs, typed payloads, error responses, pagination, filters, and compatibility rules before implementation.
Inspect an existing API or module boundary for inconsistent contracts, breaking changes, weak validation, and unsafe retry behavior.
Model idempotency keys, atomic request claims, payload matching, in-flight duplicates, and unknown outcomes for state-changing operations.
Design a REST API for [resource]. Define endpoints, typed inputs and outputs, status codes, error bodies, pagination, and naming conventions.
Review this API contract for inconsistent response shapes, validation placement, naming, and backward compatibility. Recommend specific changes: [paste contract].
Design an additive migration from [current interface] to [target interface]. Identify consumer risks, compatibility steps, deprecation timing, and verification checks.
Design an idempotent workflow for [operation]. Cover key derivation, unique storage, request hashing, concurrent duplicates, unknown outcomes, retention, and failure recovery.
المؤلف
addyosmaniالترخيص
MIT
مراجعة Skillstore
r2
تنبيه الإصدار
لم يعلن المؤلف عن إصدار.
مرجع
5d5054f8a23586f9b500fece1cb613a9dffc787b
حداثة الصيانة
١٩/٩/٢٠٢٦
الاستخدام
0 تنزيلات · 0 مشاهدات
بنية الملفات
📄 SKILL.md
مراجعة الشيفرة عبر خمسة محاور للجودة
قد تُخفي تغييرات الشيفرة مشكلات تتعلق بالصحة والأمان والبنية وسهولة القراءة والأداء. تطبق هذه المهارة عملية مراجعة منظمة وتنتج ملاحظات عملية مرتبة حسب الأولوية.
Clarify User Intent Before You Build
Underspecified requests cause teams to build the wrong outcome and discover misalignment late. This skill runs a focused, one-question interview that turns ambiguity into confirmed intent.
Plan Work Into Verifiable Tasks
Large or vague software work can hide dependencies, missing acceptance criteria, and verification gaps. This skill converts a specification into ordered task slices with checkpoints, scope guidance, and clear completion conditions.
Document Decisions and Architecture Clearly
Teams lose context when important technical decisions remain in chat, code comments, or individual memory. This skill turns architectural reasoning, API guidance, project instructions, and release changes into structured documentation.
Build Accessible, Production-Ready Frontends
Frontend work can become inconsistent, inaccessible, or difficult to maintain. This skill guides component architecture, responsive layouts, state handling, and polished user experiences.
Debug Errors with a Root-Cause Workflow
Debugging failures by guesswork wastes time and can hide the real cause. This skill provides a repeatable process for reproducing, isolating, fixing, and verifying problems.
تصميم واجهات REST وGraphQL موثوقة
بواسطة AutumnsGrove
تحتاج فرق API إلى نقاط نهاية ومصادقة وتوثيق متسقة. ترشد هذه المهارة قرارات تصميم REST وGraphQL وOpenAPI وإدارة الإصدارات والأمان.
تصميم عقود API جاهزة للإنتاج
بواسطة ArieGoldkin
غالبا ما تصمم الفرق واجهات API بموارد وأخطاء وإصدارات غير متسقة. توفر هذه المهارة أنماطا وقوائم تحقق وقوالب للعمل على REST وGraphQL وgRPC وOpenAPI وAsyncAPI.
تحسين تغطية اختبارات Playwright
بواسطة C0ntr0lledCha0s
يمكن أن تصبح مجموعات اختبارات Playwright غير مستقرة عندما تكون الإعدادات والمحددات وfixtures غير متسقة. تمنحك هذه المهارة أنماطًا عملية لاختبارات متصفح موثوقة، وتصحيح الأخطاء، وكائنات صفحات قابلة لإعادة الاستخدام.
إنشاء واجهات API باستخدام FastAPI بأنماط قابلة لإعادة الاستخدام
بواسطة 0xDarkMatter
تحتاج مشاريع FastAPI إلى اختيارات متسقة للتحقق من الصحة، والتبعيات، والبرمجيات الوسيطة، والعمل في الخلفية. تمنح هذه المهارة Claude وCodex وClaude Code أنماطًا قابلة لإعادة الاستخدام لتطوير واجهات API عملية بلغة Python.
إنشاء تطبيقات Starknet باستخدام starknet.js
بواسطة internet-court
تتطلب عمليات التكامل مع Starknet معالجة دقيقة لمزوّد الخدمة والحسابات والمعاملات والرسوم. توفّر هذه المهارة لـ Claude وCodex وClaude Code أنماطًا عملية لاستخدام starknet.js v9.
تحسين جودة كود Vue 3
بواسطة vuejs-ai
غالبا ما تتراكم في مشاريع Vue أخطاء تتعلق بالتفاعلية والمكونات والأداء مع مرور الوقت. توفر هذه المهارة إرشادات موجهة لـ Vue 3 لاستخدام أنماط أكثر أمانا وكود أوضح.