# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Browser Use Public API v2 Skills Marketplace API
  version: 1.0.0
extends: openapi/browser-use-skills-marketplace-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/marketplace/skills'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse public skills in the marketplace
      effect: read
      questions:
      - What public skills are available in the Browser Use marketplace?
      - Can I search marketplace skills by keyword or category?
      instructions:
      - text: Search the public skills marketplace for {query}.
        slots:
          query: query.query
      - text: Browse marketplace skills in category {category} published between {from} and {to}.
        slots:
          category: query.category
          from: query.fromDate
          to: query.toDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/skills/{skill_slug}'].get
  update:
    x-apievangelist-phrasing:
      intent: View a public marketplace skill
      effect: read
      questions:
      - What does a particular public marketplace skill do?
      - Can I look up a shared skill in the marketplace by its slug?
      instructions:
      - text: Show the marketplace listing for skill {skill_slug}.
        slots:
          skill_slug: path.skill_slug
      - text: Look up the public skill with slug {skill_slug}.
        slots:
          skill_slug: path.skill_slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/skills/{skill_id}/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a marketplace skill into my project
      effect: write
      questions:
      - How do I copy a public skill into my own project so I can customize it?
      - Can I clone a skill someone else published?
      instructions:
      - text: Clone marketplace skill {skill_id} into my project.
        slots:
          skill_id: path.skill_id
      - text: Make my own copy of the public skill {skill_id}.
        slots:
          skill_id: path.skill_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/skills/{skill_id}/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a public marketplace skill
      effect: write
      questions:
      - Can I run a public marketplace skill directly without cloning it first?
      - How do I pass inputs to a shared skill from the marketplace?
      instructions:
      - text: Run the marketplace skill {skill_id} with parameters {parameters}.
        slots:
          skill_id: path.skill_id
          parameters: requestBody.parameters
      - text: Execute public skill {skill_id} from the marketplace in session {session_id}.
        slots:
          skill_id: path.skill_id
          session_id: requestBody.sessionId
      method: generated
      generated: '2026-09-26'