# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gitdealflow Com Agents API
  version: 1.0.0
extends: openapi/gitdealflow-com-agents-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/api/agents.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the MCP and A2A skill catalog
      effect: read
      questions:
      - Which skills does the GitDealFlow agent expose over MCP or A2A?
      - Where can I see every agent skill with its examples and tags?
      instructions:
      - text: Fetch the unversioned agent skill catalog with examples and tags.
      - text: Show me the full list of A2A skills the agent card advertises.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/agent/tools'].get
  update:
    x-apievangelist-phrasing:
      intent: Get tool definitions for LLM tool use
      effect: read
      questions:
      - Can I drop ready-made JSON Schema tool definitions straight into my LLM agent?
      - What tool-use definitions are available in OpenAI or Anthropic format?
      instructions:
      - text: Download the JSON Schema tool definitions for direct LLM tool use.
      - text: Give me the tool-use definitions I can load into my agent runtime as-is.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/agents.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the versioned v1 agent skill catalog
      effect: read
      questions:
      - Is there a version-pinned v1 URL for the agent skill catalog?
      - Can my agent pin to a stable v1 path for the MCP / A2A skill list?
      instructions:
      - text: Fetch the agent skill catalog from the versioned v1 path.
      - text: Pull the v1 alias of the MCP and A2A skill catalog.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/openapi.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the versioned v1 OpenAPI descriptor
      effect: read
      questions:
      - Where is the versioned v1 OpenAPI document for this API?
      - Can I pin my client to a v1 URL for the OpenAPI descriptor itself?
      instructions:
      - text: Download the v1 OpenAPI descriptor for this API.
      - text: Fetch the versioned OpenAPI JSON so I can pin to it.
      method: generated
      generated: '2026-10-01'