spec.yaml

open_agent_spec: "1.5.0"

agent:
  name: document-summariser
  description: >
    Summarises a document into a concise paragraph and structured key points.
    Designed to be wrapped by a SKILL.md so interactive coding agents execute
    this typed, validated task instead of improvising their own behaviour.
  role: analyst

intelligence:
  type: llm
  engine: openai
  model: gpt-4o-mini
  # Portability is the point: the contract below is engine-agnostic. Swap the
  # two lines above for Anthropic (set ANTHROPIC_API_KEY instead of
  # OPENAI_API_KEY) and everything else — schemas, prompts, output shape —
  # stays identical:
  #   engine: anthropic
  #   model: claude-haiku-4-5-20251001

tasks:
  summarise:
    description: >
      Summarise the supplied text and return a validated, structured result.
    prompts:
      system: >
        You are a precise summarisation assistant. Respond with valid JSON
        containing exactly two fields:
        "summary" (a concise one-paragraph summary of the text) and
        "key_points" (an array of short strings, one per key takeaway).
        Return only the JSON object — no markdown fencing, no extra text.
      user: "Please summarise the following text:\n\n{text}"
    input:
      type: object
      properties:
        text:
          type: string
          description: The document text to summarise.
      required:
        - text
    output:
      type: object
      properties:
        summary:
          type: string
          description: A short summary of the document.
        key_points:
          type: array
          items:
            type: string
          description: Bullet-point key takeaways.
      required:
        - summary
        - key_points