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

# Customize the agent

> Use rules, references, skills, and saved reviewer behavior.

## Writing rules

Rules appear in the toolbar above the workspace. Add a rule, edit it, remove it, or add an example violation. Use **Apply rules to document** to ask the agent to check the current file or selected tabs.

When several tabs are open, the agent asks whether to apply the rules to the active tab, every open tab, or a selected set before it edits.

The agent can propose a new rule. A **Proposed rule** toast lets you accept or dismiss it.

Freezing a passage creates a rule for the exact text. Read [Selected text and directives](/agent/selected-text-and-directives) for the lock controls.

Saving a new rule wakes the agent with a request to bring the open files into compliance. You do not need to click Wake separately.

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/_cooIo6pWvrP0otR/images/writing-rules-panel.png?fit=max&auto=format&n=_cooIo6pWvrP0otR&q=85&s=b3da592c0cec7cee4f59c57041b64249" alt="The writing rules popover above the workspace" width="1400" height="900" data-path="images/writing-rules-panel.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/v3Rddkad7zEz0_aI/images/freeze-passage.png?fit=max&auto=format&n=v3Rddkad7zEz0_aI&q=85&s=d8de89a302197db72ede9f69aeebc3c7" alt="A frozen passage with a lock marker" width="1400" height="900" data-path="images/freeze-passage.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/v3Rddkad7zEz0_aI/images/freeze-unlock-menu.png?fit=max&auto=format&n=v3Rddkad7zEz0_aI&q=85&s=7279aff5c6284a5a3fe5e36b405da36c" alt="The unlock action for a frozen passage" width="1400" height="900" data-path="images/freeze-unlock-menu.png" />
</Frame>

## Writing references

Open **Settings**, then **Writing references**. You can use the current file, paste a writing sample, or save a URL.

References are examples for the agent to consult when a request needs them. Enable, disable, or remove a reference without changing the source file.

Adding a reference wakes the agent so it can consider the new material during the next pass.

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/_cooIo6pWvrP0otR/images/writing-references-panel.png?fit=max&auto=format&n=_cooIo6pWvrP0otR&q=85&s=561db9c70f05eda9026c99eb35c0a5a0" alt="Writing references in Settings" width="1400" height="900" data-path="images/writing-references-panel.png" />
</Frame>

## Skills

Open **Settings**, then **Skills**. Install a skill from GitHub shorthand or a local path, enable or disable it, run it as a slash command, or remove it.

DocWriter includes the plain writing and hooks creator skills. Project skills can also live under `.claude/skills/`.

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/_cooIo6pWvrP0otR/images/skills-panel.png?fit=max&auto=format&n=_cooIo6pWvrP0otR&q=85&s=21f9f395bac5d258583079965530e3e0" alt="Installed and available skills in Settings" width="1400" height="900" data-path="images/skills-panel.png" />
</Frame>

When a skill name is vague, ask the agent to find or create the right skill. Provider support differs because some providers receive skill instructions through their prompt rather than a native skill system.
