API Evangelist conversational phrasing for Browser Use Public API v2 Skills API

# 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 API
  version: 1.0.0
extends: openapi/browser-use-skills-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: 11
- target: $.paths['/skills'].get
  update:
    x-apievangelist-phrasing:
      intent: List my project's skills
      effect: read
      questions:
      - Which skills has my project built so far?
      - Can I filter my own skills by category, enabled state or whether they're public?
      - Is there a way to find skills I created within a date range?
      instructions:
      - text: List my project's skills in category {category}.
        slots:
          category: query.category
      - text: 'Search my own skills for {query}, enabled only: {enabled}.'
        slots:
          query: query.query
          enabled: query.isEnabled
      - text: Show my skills created between {from} and {to}.
        slots:
          from: query.fromDate
          to: query.toDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a new automation skill
      effect: write
      questions:
      - How do I turn a repeatable browser workflow into a reusable skill?
      - What do I have to describe for the skill to be generated automatically?
      instructions:
      - text: 'Create a skill whose goal is {goal}, guided by this prompt: {prompt}.'
        slots:
          goal: requestBody.goal
          prompt: requestBody.agentPrompt
      - text: Generate a skill titled {title} to {goal} using agent prompt {prompt}.
        slots:
          title: requestBody.title
          goal: requestBody.goal
          prompt: requestBody.agentPrompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my skills
      effect: read
      questions:
      - What are the details and current generation state of a skill I own?
      - Is one of my project's skills enabled and finished generating?
      instructions:
      - text: Show the details of my skill {skill_id}.
        slots:
          skill_id: path.skill_id
      - text: Get skill {skill_id} from my project.
        slots:
          skill_id: path.skill_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a skill I own
      effect: destructive
      questions:
      - How do I get rid of a skill my project no longer needs?
      - Can I delete a skill that belongs to my project?
      instructions:
      - text: Delete skill {skill_id} from my project.
        slots:
          skill_id: path.skill_id
      - text: Remove my skill {skill_id} permanently.
        slots:
          skill_id: path.skill_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a skill's title, categories or status
      effect: write
      questions:
      - How do I disable a skill without deleting it?
      - Can I change a skill's title, description, categories or domains after it's generated?
      instructions:
      - text: Set skill {skill_id} enabled to {enabled}.
        slots:
          skill_id: path.skill_id
          enabled: requestBody.isEnabled
      - text: Rename skill {skill_id} to {title} and describe it as {description}.
        slots:
          skill_id: path.skill_id
          title: requestBody.title
          description: requestBody.description
      - text: Tag skill {skill_id} with categories {categories} and domains {domains}.
        slots:
          skill_id: path.skill_id
          categories: requestBody.categories
          domains: requestBody.domains
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a skill's in-progress generation
      effect: destructive
      questions:
      - How do I stop a skill that's still being generated?
      - Can I abort skill generation if I gave it the wrong goal?
      instructions:
      - text: Cancel the generation running for skill {skill_id}.
        slots:
          skill_id: path.skill_id
      - text: Abort building skill {skill_id}.
        slots:
          skill_id: path.skill_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}/rollback'].post
  update:
    x-apievangelist-phrasing:
      intent: Roll a skill back to its previous version
      effect: destructive
      questions:
      - How do I revert a skill after a refinement made it worse?
      - Can a skill rollback itself be undone?
      instructions:
      - text: Roll skill {skill_id} back to its previous version.
        slots:
          skill_id: path.skill_id
      - text: Revert my skill {skill_id} to the version before the last change.
        slots:
          skill_id: path.skill_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Run one of my own skills
      effect: write
      questions:
      - How do I run a skill my project created with specific inputs?
      - Can I execute my own skill inside an existing session?
      instructions:
      - text: Execute my skill {skill_id} with parameters {parameters}.
        slots:
          skill_id: path.skill_id
          parameters: requestBody.parameters
      - text: Run my project's skill {skill_id} in session {session_id}.
        slots:
          skill_id: path.skill_id
          session_id: requestBody.sessionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}/refine'].post
  update:
    x-apievangelist-phrasing:
      intent: Improve a skill with feedback
      effect: write
      questions:
      - How do I tell a skill what it got wrong so it gets regenerated better?
      - Can I include test output and logs when refining a skill?
      instructions:
      - text: 'Refine skill {skill_id} with this feedback: {feedback}.'
        slots:
          skill_id: path.skill_id
          feedback: requestBody.feedback
      - text: Improve skill {skill_id} using feedback {feedback} and test output {output}.
        slots:
          skill_id: path.skill_id
          feedback: requestBody.feedback
          output: requestBody.testOutput
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}/executions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a skill's past executions
      effect: read
      questions:
      - How many times has a skill been run, and how did each run go?
      - Where do I see the execution history of one skill?
      instructions:
      - text: List the executions of skill {skill_id}.
        slots:
          skill_id: path.skill_id
      - text: Show page {page} of run history for skill {skill_id}.
        slots:
          page: query.pageNumber
          skill_id: path.skill_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills/{skill_id}/executions/{execution_id}/output'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a skill execution's output
      effect: read
      questions:
      - How do I download what a skill returned from a particular execution?
      - Where is the output file for one skill run stored?
      instructions:
      - text: Get a download link for the output of execution {execution_id} of skill {skill_id}.
        slots:
          execution_id: path.execution_id
          skill_id: path.skill_id
      - text: Fetch the results skill {skill_id} produced in run {execution_id}.
        slots:
          skill_id: path.skill_id
          execution_id: path.execution_id
      method: generated
      generated: '2026-09-26'