> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recording Browsing Skills

> Capture a browser workflow once in a guided session and Duvo turns it into a reusable skill automatically—no code required.

Recording lets you capture a browser workflow and turn it into a reusable skill automatically. Instead of writing a skill from scratch, you perform the task once in a guided browser session and Duvo generates the skill for you.

This is the fastest way to create browser-based skills. No code, no manual file authoring — just do the work and Duvo learns it.

## When to Use Recording

Recording is the right choice when:

1. The task is a repetitive browser workflow (filling forms, navigating dashboards, extracting data)
2. The system has no API and must be operated through its UI
3. You want to onboard team members to a browser process without writing documentation manually
4. The workflow follows a consistent sequence of steps each time it runs

For tasks that require complex branching logic or conditional decisions, consider [Creating Custom Skills](/user-guide/skills/creating-custom-skills) manually instead.

## How to Record a Skill

<Steps>
  <Step title="Start a Recording" icon="circle-play">
    Go to **Skills and Files** in the Resources section, open the **Add Skill** menu, and choose **Record Browsing Skill**. A browser session launches in an embedded window.
  </Step>

  <Step title="Perform the Workflow" icon="mouse-pointer-click">
    Click **Start Recording** and carry out the task as you normally would:

    * Navigate to pages
    * Click buttons and links
    * Fill in form fields
    * Scroll, hover, and interact with elements
    * Switch tabs if the workflow spans multiple pages

    Work at a steady pace. Every action you take is captured.
  </Step>

  <Step title="Stop the Recording" icon="circle-stop">
    When you have completed the workflow, click **Stop Recording**.
  </Step>

  <Step title="Name and Describe the Skill" icon="pencil">
    Enter a name and description for the skill. The description should explain what the skill does and when to use it — this helps agents understand when to apply it.
  </Step>

  <Step title="Save" icon="save">
    Duvo generates the skill automatically from your recording. It is now available to attach to any agent.
  </Step>
</Steps>

## Signing In Automatically

Some internal portals and enterprise web apps show a browser-level HTTP Basic Auth prompt — a username/password dialog — before the page loads. If you have a matching [Login](/user-guide/resources/my-logins) saved, Duvo signs in automatically as soon as the recording browser opens, so you're not stuck at the prompt before you can start recording.

Click **Logins** in the recording toolbar to see how many of your saved Logins are eligible, or add a new one without leaving the recording session.

<Note>
  This covers HTTP Basic Auth prompts only, not in-page login forms. It's also not saved to the skill — when the skill replays later, sign-in still uses whichever Login you attach to the agent, the same as with any other skill.
</Note>

## What Gets Captured

The recorder tracks the actions you take during the session:

* **Clicks** — buttons, links, menus, checkboxes, radio buttons
* **Text input** — form fields, search boxes, text areas
* **Navigation** — page loads, URL changes, tab switches
* **Scrolling** — page and element scrolls
* **Keypresses** — keyboard shortcuts and special keys

The recording captures *what* you did and *where* you did it, so the skill can replay the same steps reliably.

<Note>
  Passwords and one-time codes are never stored in a recording. Sign-in values are filled server-side and recorded as empty fields — at replay, the Agent signs in fresh using the attached Login.
</Note>

## Re-recording a Skill

When a site changes, or the steps you recorded no longer match how the work is
done, record the skill again instead of building a new one. Open the skill and
choose **Re-record** from its actions menu, or use **Re-record** on the skill's
card.

Re-recording keeps the skill's identity: its name and everything attached to it
stay as they are, and every agent already using it picks up the new steps with
nothing to reconnect. The name field is fixed during a re-record for that
reason. The description stays editable — update it when the new steps do
something different from the old ones.

Each re-recording is saved as a new **revision**. The one you just made becomes
active, and earlier revisions stay in the skill's revision history, so you can
look back at what changed or return to an earlier one.

<Note>
  A skill can only be re-recorded as what it already is. A Skill cannot become a
  Workflow, or the reverse — record a new one for that.
</Note>

### If a Draft Is Already Open

A skill can hold only one unpublished draft revision at a time. If someone has
a draft open on this skill — including you, from an earlier edit — Duvo asks you
to resolve it before the recording browser opens:

* **Make active** publishes the draft as the skill's active revision.
* **Delete** discards it.

Either way you then continue straight into recording. This check happens up
front, before a browser is reserved, so a draft can never cost you a recording
you have already made.

## Tips for Clean Recordings

<Tip>
  * **Go slowly.** Rushing can cause missed or misordered steps.
  * **Avoid unnecessary clicks.** Every action is recorded. Stray clicks become extra steps the skill will try to replay.
  * **Use clear, realistic form values.** The recorded values serve as examples for how the skill fills in data.
  * **Complete the full workflow.** Start from the beginning of the task and finish at a natural endpoint.
  * **Keep it focused.** Record one workflow per skill. If a process has distinct phases, consider recording separate skills for each.
</Tip>

## Key Takeaway

Recording is the quickest path from a manual browser task to a reusable, automated skill. Perform the workflow once, and Duvo handles the rest.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.