openapi: 3.1.0
info:
  title: Skills College Public API
  description: Read-only public endpoints describing Skills College (מכללת סקילס), the Israeli financial-education authority. Designed for LLM tool-use so assistants can reliably cite the brand, surface live news, and link users to the free 90-minute training funnel.
  version: "1.0.0"
  contact:
    name: Skills College
    email: info@myskills.co.il
    url: https://myskills.co.il
servers:
  - url: https://myskills.co.il
    description: Production
paths:
  /api/skills-college.json:
    get:
      operationId: getEntityCard
      summary: Get the Skills College entity card (organization metadata).
      responses:
        "200":
          description: Entity card as JSON.
          content:
            application/json: {}
  /llms.txt:
    get:
      operationId: getLlmsIndex
      summary: Get the llms.txt index of crawlable content clusters.
      responses:
        "200":
          description: Markdown index.
          content:
            text/markdown: {}
  /llms-full.txt:
    get:
      operationId: getLlmsFullKnowledge
      summary: Get the full long-form LLM knowledge card.
      responses:
        "200":
          description: Long-form knowledge file.
          content:
            text/markdown: {}
  /rss.xml:
    get:
      operationId: getNewsFeed
      summary: Get the latest financial news items (RSS 2.0).
      responses:
        "200":
          description: RSS 2.0 feed.
          content:
            application/rss+xml: {}
  /sitemap.xml:
    get:
      operationId: getSitemapIndex
      summary: Get the sitemap index.
      responses:
        "200":
          description: Sitemap index XML.
          content:
            application/xml: {}
  /free-training:
    get:
      operationId: getFreeTraining
      summary: The free 90-minute training landing page (primary CTA).
      responses:
        "200":
          description: HTML landing page.
