{
  "schema_version": "2026-03-26",
  "generated_at": "2026-03-28T00:00:00+00:00",
  "id": "mcp-server-authoring",
  "slug": "mcp-server-authoring",
  "display_name": "MCP Server Authoring",
  "description": "MCP server authoring workflow skill. Use this skill when a team needs to design, implement, validate, or document a Model Context Protocol server with stable tools, resources, prompts, transports, and client compatibility.",
  "version": "0.0.1",
  "raw_category": "tools",
  "canonical_category": "tools",
  "taxonomy": {
    "raw_category": "tools",
    "canonical_category": "tools",
    "inferred_category": "tools",
    "category_source": "frontmatter"
  },
  "tags": [
    "mcp",
    "protocol",
    "server",
    "tools",
    "resources",
    "prompts",
    "sdk"
  ],
  "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-28",
    "updated": "2026-03-28",
    "file_mtime": "2026-03-28T00:00:00+00:00"
  },
  "paths": {
    "root": "skills/mcp-server-authoring",
    "entrypoint": "skills/mcp-server-authoring/SKILL.md",
    "metadata": "skills/mcp-server-authoring/metadata.json"
  },
  "resources": {
    "sub_resources": [
      "agents",
      "examples",
      "references",
      "scripts"
    ],
    "files": [
      "SKILL.md",
      "openai.yaml",
      "mcp-rollout-example.md",
      "checklist.md",
      "tool-contract-worksheet.md",
      "render_mcp_server_packet.py"
    ],
    "files_count": 6,
    "references_count": 2,
    "agents_count": 1,
    "assets_count": 0
  },
  "content": {
    "body_length": 5737,
    "content_length": 6311,
    "body_lines": 115,
    "word_count": 801,
    "has_code_blocks": true,
    "typed_code_blocks_count": 1,
    "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": 3,
    "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": 506,
      "when_to_use_section_length": 411,
      "best_practices_items_count": 6,
      "best_practices_section_length": 436,
      "troubleshooting_items_count": 0,
      "troubleshooting_section_length": 944,
      "resources_items_count": 4,
      "resources_section_length": 252,
      "examples_section_length": 925,
      "examples_code_blocks_count": 6,
      "related_skills_section_length": 294,
      "decision_assets_count": 10,
      "table_count": 7,
      "linked_resource_families_count": 4,
      "linked_resource_families": [
        "agents",
        "examples",
        "references",
        "scripts"
      ],
      "support_links_count": 4,
      "support_files_count": 5,
      "references_files_count": 2,
      "scripts_files_count": 1,
      "examples_files_count": 1,
      "agents_files_count": 1,
      "assets_files_count": 0,
      "tools_count": 6,
      "tags_count": 7,
      "body_density": 6.97
    }
  },
  "maturity": {
    "skill_level": 3,
    "skill_level_label": "resources",
    "has_scripts": true,
    "has_extra_files": true
  },
  "best_practices": {
    "score": 97,
    "tier": "excellent",
    "signals": {
      "workflow_steps_count": 5,
      "workflow_section_length": 506,
      "when_to_use_section_length": 411,
      "best_practices_items_count": 6,
      "best_practices_section_length": 436,
      "troubleshooting_items_count": 0,
      "troubleshooting_section_length": 944,
      "resources_items_count": 4,
      "resources_section_length": 252,
      "examples_section_length": 925,
      "examples_code_blocks_count": 6,
      "related_skills_section_length": 294,
      "decision_assets_count": 10,
      "table_count": 7,
      "linked_resource_families_count": 4,
      "linked_resource_families": [
        "agents",
        "examples",
        "references",
        "scripts"
      ],
      "support_links_count": 4,
      "support_files_count": 5,
      "references_files_count": 2,
      "scripts_files_count": 1,
      "examples_files_count": 1,
      "agents_files_count": 1,
      "assets_files_count": 0,
      "tools_count": 6,
      "tags_count": 7,
      "body_density": 6.97
    }
  },
  "quality": {
    "score": 95,
    "tier": "platinum",
    "breakdown": {
      "body": 16,
      "description": 10,
      "metadata": 12,
      "recency": 8,
      "resources": 10,
      "best_practices": 9,
      "semantic_depth": 16,
      "operational_depth": 10,
      "support_pack": 10
    }
  },
  "security": {
    "score": 95,
    "tier": "review",
    "status": "passed",
    "findings_count": 0,
    "findings": [],
    "signals": {
      "scanned_files": 6,
      "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/mcp-server-authoring/scripts/render_mcp_server_packet.py",
            "sha256": "fb65c96a7a58cc84a9f661f2e9fbae018aa62b74d5504a21a824c1ec633dd969",
            "status": "not_found"
          }
        ],
        "details": "Hash lookups only. Unknown files are not uploaded during validation."
      }
    }
  },
  "validation": {
    "errors": [],
    "warnings": [],
    "status": "passed"
  }
}