{
  "schema_version": "agent-skills.v1",
  "name": "git-top",
  "title": "Git.Top Agent Skills",
  "description": "Reusable public skills that agents can perform through Git.Top REST and MCP surfaces.",
  "auth": {
    "type": "none",
    "policy_url": "https://git.top/auth.md"
  },
  "skills": [
    {
      "id": "discover_open_source_projects",
      "name": "Discover open-source projects",
      "description": "Find candidate GitHub projects by use case, category, deployment target, language, and Cloudflare readiness.",
      "entrypoints": [
        {
          "type": "rest",
          "method": "GET",
          "url": "https://git.top/api/search?q={query}&limit=5"
        },
        {
          "type": "mcp_tool",
          "endpoint": "https://git.top/mcp",
          "name": "search_projects"
        }
      ],
      "outputs": [
        "projects",
        "metadata",
        "classification",
        "quality_signal_confidence"
      ]
    },
    {
      "id": "recommend_project_stack",
      "name": "Recommend a project stack",
      "description": "Return ranked recommendations with fit profiles, tradeoffs, adoption plans, risk flags, and next actions.",
      "entrypoints": [
        {
          "type": "rest",
          "method": "POST",
          "url": "https://git.top/api/recommend"
        },
        {
          "type": "mcp_tool",
          "endpoint": "https://git.top/mcp",
          "name": "recommend_project"
        }
      ],
      "outputs": [
        "recommendations",
        "decision_summary",
        "fit_profile",
        "adoption_plan",
        "risk_flags"
      ]
    },
    {
      "id": "compare_projects",
      "name": "Compare projects",
      "description": "Compare shortlisted projects with decision matrices, winner reasoning, score explanations, and graph-aware next actions.",
      "entrypoints": [
        {
          "type": "rest",
          "method": "POST",
          "url": "https://git.top/api/compare"
        },
        {
          "type": "mcp_tool",
          "endpoint": "https://git.top/mcp",
          "name": "compare_projects"
        }
      ],
      "outputs": [
        "summary",
        "decision_matrix",
        "ordered_projects",
        "winner",
        "reasoning"
      ]
    },
    {
      "id": "inspect_project_graph",
      "name": "Inspect a project graph",
      "description": "Retrieve focused graph relationships across alternatives, related projects, deployment targets, dependencies, and use cases.",
      "entrypoints": [
        {
          "type": "rest",
          "method": "POST",
          "url": "https://git.top/api/graph"
        },
        {
          "type": "mcp_tool",
          "endpoint": "https://git.top/mcp",
          "name": "get_project_graph"
        }
      ],
      "outputs": [
        "summary",
        "graph_stats",
        "relationship_groups",
        "nodes",
        "edges"
      ]
    },
    {
      "id": "check_trust_and_quality",
      "name": "Check trust and quality",
      "description": "Verify D1 source availability, freshness, public benchmark health, quality scores, known limitations, and review queues.",
      "entrypoints": [
        {
          "type": "rest",
          "method": "GET",
          "url": "https://git.top/api/trust"
        },
        {
          "type": "rest",
          "method": "GET",
          "url": "https://git.top/api/benchmark"
        },
        {
          "type": "mcp_tool",
          "endpoint": "https://git.top/mcp",
          "name": "get_trust_gate"
        },
        {
          "type": "mcp_tool",
          "endpoint": "https://git.top/mcp",
          "name": "get_public_benchmark"
        }
      ],
      "outputs": [
        "decision",
        "checks",
        "benchmark",
        "quality",
        "metadata"
      ]
    }
  ]
}