{
  "schema_version": "2026-03-26",
  "generated_at": "2026-03-27T00:00:00+00:00",
  "id": "api-design",
  "slug": "api-design",
  "display_name": "API Design",
  "description": "API design workflow skill. Use this skill when a user needs a clear HTTP or service contract before implementation.",
  "version": "0.0.1",
  "raw_category": "backend",
  "canonical_category": "backend",
  "taxonomy": {
    "raw_category": "backend",
    "canonical_category": "backend",
    "inferred_category": "backend",
    "category_source": "frontmatter"
  },
  "tags": [
    "api",
    "backend",
    "contracts",
    "http",
    "json",
    "errors"
  ],
  "tools": [
    "claude-code",
    "cursor",
    "gemini-cli",
    "codex-cli",
    "antigravity",
    "opencode"
  ],
  "complexity": "advanced",
  "risk": "safe",
  "source": "omni-team",
  "author": "Omni Skills Team",
  "dates": {
    "added": "2026-03-26",
    "updated": "2026-03-27",
    "file_mtime": "2026-03-27T00:00:00+00:00"
  },
  "paths": {
    "root": "skills/api-design",
    "entrypoint": "skills/api-design/SKILL.md",
    "metadata": "skills/api-design/metadata.json"
  },
  "resources": {
    "sub_resources": [
      "agents",
      "examples",
      "references",
      "scripts"
    ],
    "files": [
      "SKILL.md",
      "openai.yaml",
      "error-contract-rubric.md",
      "mutation-review-worksheet.md",
      "request-envelope-template.json",
      "checklist.md",
      "compatibility-review-checklist.md",
      "render_brief.py"
    ],
    "files_count": 8,
    "references_count": 2,
    "agents_count": 1,
    "assets_count": 0
  },
  "content": {
    "body_length": 4982,
    "content_length": 5431,
    "body_lines": 117,
    "word_count": 654,
    "has_code_blocks": true,
    "typed_code_blocks_count": 2,
    "has_examples_section": true,
    "example_count": 3,
    "has_workflow_section": true,
    "has_when_to_use_section": true,
    "has_best_practices_section": true,
    "has_troubleshooting_section": true,
    "problem_count": 3,
    "troubleshooting_pairs_count": 2,
    "has_additional_resources_section": true,
    "has_related_skills_section": true,
    "related_skills_count": 3,
    "has_local_support_links": true,
    "local_support_links_count": 3,
    "has_local_script_example": true,
    "local_script_example_count": 0,
    "semantic_signals": {
      "workflow_steps_count": 5,
      "workflow_section_length": 607,
      "when_to_use_section_length": 199,
      "best_practices_items_count": 6,
      "best_practices_section_length": 440,
      "troubleshooting_items_count": 0,
      "troubleshooting_section_length": 760,
      "resources_items_count": 6,
      "resources_section_length": 555,
      "examples_section_length": 822,
      "examples_code_blocks_count": 6,
      "related_skills_section_length": 250,
      "decision_assets_count": 18,
      "table_count": 6,
      "linked_resource_families_count": 4,
      "linked_resource_families": [
        "agents",
        "examples",
        "references",
        "scripts"
      ],
      "support_links_count": 6,
      "support_files_count": 7,
      "references_files_count": 2,
      "scripts_files_count": 1,
      "examples_files_count": 3,
      "agents_files_count": 1,
      "assets_files_count": 0,
      "tools_count": 6,
      "tags_count": 6,
      "body_density": 5.59
    }
  },
  "maturity": {
    "skill_level": 3,
    "skill_level_label": "resources",
    "has_scripts": true,
    "has_extra_files": true
  },
  "best_practices": {
    "score": 100,
    "tier": "excellent",
    "signals": {
      "workflow_steps_count": 5,
      "workflow_section_length": 607,
      "when_to_use_section_length": 199,
      "best_practices_items_count": 6,
      "best_practices_section_length": 440,
      "troubleshooting_items_count": 0,
      "troubleshooting_section_length": 760,
      "resources_items_count": 6,
      "resources_section_length": 555,
      "examples_section_length": 822,
      "examples_code_blocks_count": 6,
      "related_skills_section_length": 250,
      "decision_assets_count": 18,
      "table_count": 6,
      "linked_resource_families_count": 4,
      "linked_resource_families": [
        "agents",
        "examples",
        "references",
        "scripts"
      ],
      "support_links_count": 6,
      "support_files_count": 7,
      "references_files_count": 2,
      "scripts_files_count": 1,
      "examples_files_count": 3,
      "agents_files_count": 1,
      "assets_files_count": 0,
      "tools_count": 6,
      "tags_count": 6,
      "body_density": 5.59
    }
  },
  "quality": {
    "score": 95,
    "tier": "platinum",
    "breakdown": {
      "body": 16,
      "description": 9,
      "metadata": 12,
      "recency": 8,
      "resources": 10,
      "best_practices": 10,
      "semantic_depth": 16,
      "operational_depth": 10,
      "support_pack": 10
    }
  },
  "security": {
    "score": 95,
    "tier": "review",
    "status": "passed",
    "findings_count": 0,
    "findings": [],
    "signals": {
      "scanned_files": 8,
      "script_files": 1,
      "binary_like_files": 0
    },
    "scanners": {
      "static": {
        "enabled": true,
        "status": "completed"
      },
      "clamav": {
        "enabled": true,
        "status": "completed",
        "provider": "clamav",
        "detections": [],
        "infected_files": 0
      },
      "virustotal": {
        "enabled": true,
        "status": "completed",
        "provider": "virustotal",
        "lookups": 1,
        "positives": 0,
        "results": [
          {
            "path": "skills/api-design/scripts/render_brief.py",
            "sha256": "95f6df80f9fa925d1e86d70ed4b8952a88cc30d244d3e2ce6398a6c83820d6f9",
            "status": "not_found"
          }
        ],
        "details": "Hash lookups only. Unknown files are not uploaded during validation."
      }
    }
  },
  "validation": {
    "errors": [],
    "warnings": [],
    "status": "passed"
  }
}