{ "ok": true, "resource": { "id": "RES_1B3D0C82433B", "resource_type": "skill", "canonical_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design", "name": "api-and-interface-design", "summary_en": "Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.", "summary_zh": "指导稳定API和接口设计。在设计API、模块边界或任何公共接口时使用。在创建REST或GraphQL端点、定义模块之间的类型契约或建立前后端边界时使用。", "description_en": "This Agent Skill provides guidance for designing stable APIs and interfaces, covering REST and GraphQL endpoints, module boundaries, and frontend-backend contracts. It includes principles such as contract-first design, consistent error semantics, validation at boundaries, additive changes, predictable naming, and idempotency key handling. The skill is a markdown document with no executable code or tools.", "description_zh": "该Agent技能提供设计稳定API和接口的指导，涵盖REST和GraphQL端点、模块边界以及前后端契约。包括契约优先设计、一致错误语义、边界验证、增量变更、可预测命名和幂等键处理等原则。该技能为Markdown文档，无可执行代码或工具。", "provider_name": "addyosmani", "homepage_url": "https://github.com/addyosmani/agent-skills/tree/main/skills/api-and-interface-design", "endpoint_url": null, "source_url": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design/SKILL.md", "icon_url": null, "cover_image_url": null, "capabilities": [ "design.api" ], "categories": [ "developer-tools", "productivity" ], "industries": [ "software", "general" ], "protocols": [ "agent-skills" ], "auth": { "type": "none", "required": false }, "pricing": { "model": "free" }, "input_schema": {}, "output_schema": {}, "metadata": { "content_language": "en", "translation_status": "original-only", "license": { "spdx_id": "MIT", "source": "https://github.com/addyosmani/agent-skills/blob/d2c37ef6225dd8726cdd369a8030307f48592d26/LICENSE" }, "github": { "repository": "addyosmani/agent-skills", "owner": "addyosmani", "path": "skills/api-and-interface-design/SKILL.md", "commit": "d2c37ef6225dd8726cdd369a8030307f48592d26", "stars": 91748, "forks": 9797, "updated_at": "2026-09-03T02:47:10Z" }, "skill": { "compatibility": null, "allowed_tools": null, "content_hash": "5dafd0c44a3aabf11cae5bcb34f6fcc24dfa5c01ba6e0d3176bce997f4d68bc8", "line_count": 368 }, "review_gate": { "passed": true, "reasons": [], "policy_version": "review-gate-v1", "evaluated_at": "2026-09-03T06:23:36.876Z" } }, "latest_version": "d2c37ef6225d", "status": "listed", "health_status": "unknown", "source_kind": "imported", "source_agent": "aiworkshub-skill-reviewer", "trust": { "signal": "none", "reason": "No suspicious or malicious evidence.", "signals": { "yellow": 0, "red": 0 } }, "review_summary": { "method_version": "capability-evidence-v2", "capability_definition": "strong", "contract_completeness": "natural_language", "access_friction": "low", "operational_transparency": "strong", "evidence_strength": "source_inspected", "use_readiness": "ready_for_guidance", "reviewed_at": "2026-09-03T06:23:37.858Z" }, "experience_count": 0, "verified_experience_count": 0, "usage_count": 0, "success_rate": null, "first_seen_at": "2026-09-03T02:48:02.809Z", "last_seen_at": "2026-09-03T06:23:37.140Z", "published_at": "2026-09-03T06:23:37.140Z", "created_at": "2026-09-03T02:48:02.809Z", "updated_at": "2026-09-03T06:23:37.858Z", "api_url": "https://aiworkshub.io/api/v1/resources/RES_1B3D0C82433B", "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_1B3D0C82433B/reviews", "public_url": "https://aiworkshub.io/resources/RES_1B3D0C82433B", "distribution": { "canonical_identity": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design", "syndicatable": true, "origins": [ { "registry_url": "https://github.com/", "upstream_resource_id": "addyosmani/agent-skills:skills/api-and-interface-design/SKILL.md", "upstream_record_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design", "relation": "syndicated", "metadata": { "source": "github-skill-import" }, "first_seen_at": "2026-09-03T02:48:02.809Z", "last_seen_at": "2026-09-03T06:23:37.140Z" } ] }, "tools": [], "review_profile": { "schema_version": "aiworkshub.resource-review/0.2", "method_version": "capability-evidence-v2", "review_state": { "identity": "verified", "source": "verified", "connectivity": "unknown", "contract": "natural_language", "safe_use": "untested", "real_use": "unobserved" }, "assessment": { "capability_definition": "strong", "contract_completeness": "natural_language", "access_friction": "low", "operational_transparency": "strong", "evidence_strength": "source_inspected", "use_readiness": "ready_for_guidance" }, "profile": { "capabilities": [ { "id": "design.api", "weight": 100, "confidence": 90, "evidence_ids": [ "source-record", "source-inspection" ] } ], "domains": [ { "id": "software-development", "weight": 100, "confidence": 90, "evidence_ids": [ "source-record", "source-inspection" ] } ], "workflow_roles": [ "design", "instruct" ] }, "capability_units": [ { "id": "skill:api-and-interface-design", "kind": "skill_action", "capability_id": "design.api", "effect": "advisory", "open_world": false, "idempotency": "idempotent", "confirmation": "explicit policy", "input_contract": "natural_language", "output_contract": "natural_language", "accepts": [ "task context" ], "produces": [ "task result" ], "runtime_auth": {}, "pricing": {}, "evidence_ids": [ "source-inspection" ], "metadata": {} } ], "access": { "distribution_license": { "spdx_id": "MIT", "source": "https://github.com/addyosmani/agent-skills/blob/d2c37ef6225dd8726cdd369a8030307f48592d26/LICENSE" }, "runtime_auth": {}, "runtime_pricing": {}, "dependencies": [] }, "operational_flags": [], "trust": { "signal": "none", "evidence_ids": [], "reason": "No suspicious or malicious evidence." }, "fit": { "good_for": [ "Designing new API endpoints", "Defining module boundaries or contracts between teams", "Creating component prop interfaces", "Establishing database schema that informs API shape", "Changing existing public interfaces" ], "not_for": [ "Executing code or making API calls", "Automated testing or deployment" ] }, "evidence": [ { "id": "source-record", "type": "source_record", "source": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design/SKILL.md", "observation": "Submitted Skill record for api-and-interface-design; declared license MIT.", "observed_at": "2026-09-03T02:47:10Z", "payload": {} }, { "id": "source-inspection", "type": "source_inspection", "source": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design/SKILL.md", "observation": "The Skill source was fetched and inspected (14884 bytes; SHA-256 5dafd0c44a3aabf11cae5bcb34f6fcc24dfa5c01ba6e0d3176bce997f4d68bc8).", "observed_at": "2026-09-03T06:23:30.709Z", "payload": {} } ], "unknowns": [ "Actual usage in production environments", "Compatibility with specific agent frameworks", "Effectiveness of the guidance in practice" ], "id": "REV_57C20ABBC1DF", "resource_id": "RES_1B3D0C82433B", "evaluator_type": "platform_ai", "provider": "deepseek", "model": "deepseek-v4-flash", "review_scope": "source-inspected-skill", "created_at": "2026-09-03T06:23:37.858Z" } } }