# 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'