---
name: uru-prompts
description: Create, find, refine, and apply reusable Uru Prompts. Use for prompt templates, variables, Agent prompt attachments, or Prompt Library organization.
---

# Uru Prompts

An Uru Prompt is a reusable instruction resource in the Library.

Use `library_query` for Prompt search and read. Use `library_fs` for create,
write, patch, move, trash, and restore.

## Workflow

1. Search with `library_query` and `resource_type="prompt"`.
2. Read the best match.
3. Reuse or improve that Prompt when it already has the same job.
4. Create a Prompt only when no suitable Prompt exists.
5. Read the saved result.
6. Report its Library path and variables.

Create a Prompt:

```json
{
  "op": "write",
  "path": "library/Prompts/Weekly Status.md",
  "content": "# Weekly status for [team_name]\n\n## Results\n[results]\n\n## Next\n[next_steps]",
  "create": true
}
```

Replace a complete Prompt only after a read. Use `patch_preview` and `patch`
for a small change when you must preserve unrelated text.

## Variable rules

Use square brackets:

```text
[customer_name]
[reporting_period]
[source_material]
```

- Use lowercase names with underscores.
- Use one name for one value.
- Keep the variable set small.
- Do not put variable definitions in frontmatter.
- Do not put secrets in variables or Prompt content.

Uru derives the variable list from the saved Prompt body.

## Prompt quality

- Give the Prompt one clear job.
- State the required inputs.
- State the output format.
- State quality checks.
- Keep durable policy separate from one-time task data.
- Include an example only when it removes real ambiguity.
- Remove repeated or conflicting instructions.

## Agent attachments

An Agent can attach a Prompt as a reusable resource. A Prompt attachment does
not feed automatic retrieval. It appears in the Agent's Library inventory.

Read the current Agent through `library_query` before you change its linked
Prompt references. Edit the returned Agent JSON through `library_fs`. Preserve
unrelated links.

Do not tell an external assistant to silently apply every Prompt attached to an
Agent. The task and active Agent instructions decide which Prompt is relevant.

## Links and Library work

Prompt text can contain id-pinned links or `[[Name]]` references. Uru derives
backlinks when it saves the Prompt. Backlinks do not attach the Prompt to an
Agent.

Use `uru-library` for links, sharing, comments, labels, versions, Collections,
and distribution.

## Stop rules

- Do not use retired Prompt CRUD tools when the Library path works.
- Do not overwrite a Prompt that you did not read.
- Do not invent resource ids or slugs.
- Do not put access tokens or secret values in a Prompt.
- Stop after a conflict. Read the current Prompt before retrying.