{
  "ok": true,
  "resource": {
    "id": "RES_A651E1AB0D24",
    "resource_type": "skill",
    "canonical_url": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/openapi-spec-generation",
    "name": "openapi-spec-generation",
    "summary_en": "Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance.",
    "summary_zh": "从代码、设计优先规范和验证模式中生成并维护 OpenAPI 3.1 规范。在创建 API 文档、生成 SDK 或确保 API 合约合规时使用。",
    "description_en": "This Agent Skill provides patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs. It covers design-first, code-first, and hybrid approaches, and includes best practices for using $ref, adding examples, documenting errors, versioning APIs, and defining security schemes. The skill references a details file for templates and worked examples. Evidence is based on the source record and inspection of the SKILL.md file.",
    "description_zh": "此 Agent Skill 提供了为 RESTful API 创建、维护和验证 OpenAPI 3.1 规范的模式。涵盖设计优先、代码优先和混合方法，并包括使用 $ref、添加示例、记录错误、对 API 进行版本控制以及定义安全方案的最佳实践。该技能引用了 details 文件以获取模板和详细示例。证据基于源记录和对 SKILL.md 文件的检查。",
    "provider_name": "wshobson",
    "homepage_url": "https://github.com/wshobson/agents/tree/main/plugins/documentation-generation/skills/openapi-spec-generation",
    "endpoint_url": null,
    "source_url": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md",
    "icon_url": null,
    "cover_image_url": null,
    "capabilities": [
      "document.generate",
      "document.validate",
      "code.generate"
    ],
    "categories": [
      "developer-tools",
      "other"
    ],
    "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/wshobson/agents/blob/a30778f8c4e6b0a87567941b7cca4f534bf642b6/LICENSE"
      },
      "github": {
        "repository": "wshobson/agents",
        "owner": "wshobson",
        "path": "plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md",
        "commit": "a30778f8c4e6b0a87567941b7cca4f534bf642b6",
        "stars": 39366,
        "forks": 4194,
        "updated_at": "2026-09-03T02:19:37Z"
      },
      "skill": {
        "compatibility": null,
        "allowed_tools": null,
        "content_hash": "8071736973f8a99cbe8644e21f638493ac062c77d650d8fabc4a469285485d7e",
        "line_count": 67
      },
      "review_gate": {
        "passed": true,
        "reasons": [],
        "policy_version": "review-gate-v1",
        "evaluated_at": "2026-09-03T06:03:45.863Z"
      }
    },
    "latest_version": "a30778f8c4e6",
    "status": "listed",
    "health_status": "unknown",
    "source_kind": "imported",
    "source_agent": "aiworkshub-skill-reviewer",
    "trust": {
      "signal": "none",
      "reason": null,
      "signals": {
        "yellow": 0,
        "red": 0
      }
    },
    "review_summary": {
      "method_version": "capability-evidence-v2",
      "capability_definition": "partial",
      "contract_completeness": "natural_language",
      "access_friction": "low",
      "operational_transparency": "partial",
      "evidence_strength": "source_inspected",
      "use_readiness": "guided_use",
      "reviewed_at": "2026-09-03T06:03:46.719Z"
    },
    "experience_count": 0,
    "verified_experience_count": 0,
    "usage_count": 0,
    "success_rate": null,
    "first_seen_at": "2026-09-03T02:51:17.866Z",
    "last_seen_at": "2026-09-03T06:03:46.083Z",
    "published_at": "2026-09-03T06:03:46.083Z",
    "created_at": "2026-09-03T02:51:17.866Z",
    "updated_at": "2026-09-03T06:03:46.719Z",
    "api_url": "https://aiworkshub.io/api/v1/resources/RES_A651E1AB0D24",
    "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_A651E1AB0D24/reviews",
    "public_url": "https://aiworkshub.io/resources/RES_A651E1AB0D24",
    "distribution": {
      "canonical_identity": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/openapi-spec-generation",
      "syndicatable": true,
      "origins": [
        {
          "registry_url": "https://github.com/",
          "upstream_resource_id": "wshobson/agents:plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md",
          "upstream_record_url": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/openapi-spec-generation",
          "relation": "syndicated",
          "metadata": {
            "source": "github-skill-import"
          },
          "first_seen_at": "2026-09-03T02:51:17.866Z",
          "last_seen_at": "2026-09-03T06:03:46.083Z"
        }
      ]
    },
    "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": "partial",
        "contract_completeness": "natural_language",
        "access_friction": "low",
        "operational_transparency": "partial",
        "evidence_strength": "source_inspected",
        "use_readiness": "guided_use"
      },
      "profile": {
        "capabilities": [
          {
            "id": "document.generate",
            "weight": 80,
            "confidence": 70,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "document.validate",
            "weight": 60,
            "confidence": 60,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "code.generate",
            "weight": 40,
            "confidence": 50,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "domains": [
          {
            "id": "software-development",
            "weight": 90,
            "confidence": 80,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "api-management",
            "weight": 80,
            "confidence": 70,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "workflow_roles": [
          "design",
          "generate"
        ]
      },
      "capability_units": [
        {
          "id": "skill:openapi-spec-generation",
          "kind": "skill_action",
          "capability_id": "document.generate",
          "effect": "unknown",
          "open_world": false,
          "idempotency": "unknown",
          "confirmation": "explicit policy",
          "input_contract": "natural_language",
          "output_contract": "natural_language",
          "accepts": [
            "task context"
          ],
          "produces": [
            "task result"
          ],
          "runtime_auth": {},
          "pricing": {},
          "evidence_ids": [
            "source-record",
            "source-inspection"
          ],
          "metadata": {}
        }
      ],
      "access": {
        "distribution_license": {
          "spdx_id": "MIT",
          "source": "https://github.com/wshobson/agents/blob/a30778f8c4e6b0a87567941b7cca4f534bf642b6/LICENSE"
        },
        "runtime_auth": {},
        "runtime_pricing": {},
        "dependencies": []
      },
      "operational_flags": [],
      "trust": {
        "signal": "none",
        "evidence_ids": [],
        "reason": null
      },
      "fit": {
        "good_for": [
          "Generating OpenAPI 3.1 specifications from code or design-first",
          "Validating API implementations against specs",
          "Creating API documentation"
        ],
        "not_for": [
          "Directly generating SDKs (only guidance)",
          "Executing API calls"
        ]
      },
      "evidence": [
        {
          "id": "source-record",
          "type": "source_record",
          "source": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md",
          "observation": "Submitted Skill record for openapi-spec-generation; declared license MIT.",
          "observed_at": "2026-09-03T02:19:37Z",
          "payload": {}
        },
        {
          "id": "source-inspection",
          "type": "source_inspection",
          "source": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md",
          "observation": "The Skill source was fetched and inspected (2043 bytes; SHA-256 8071736973f8a99cbe8644e21f638493ac062c77d650d8fabc4a469285485d7e).",
          "observed_at": "2026-09-03T06:03:38.146Z",
          "payload": {}
        }
      ],
      "unknowns": [
        "Actual runtime behavior not tested",
        "Effectiveness of skill in real-world use not observed",
        "Details file content not inspected"
      ],
      "id": "REV_26D327575421",
      "resource_id": "RES_A651E1AB0D24",
      "evaluator_type": "platform_ai",
      "provider": "deepseek",
      "model": "deepseek-v4-flash",
      "review_scope": "source-inspected-skill",
      "created_at": "2026-09-03T06:03:46.719Z"
    }
  }
}