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

# Turn Plannotator Feedback into Agent Skills

> Use feedback from plan reviews, document annotations, and code reviews to create agent skills that match your preferences.

Plannotator sends your comments back to the agent that asked for the review. Save the feedback you want to reuse in one folder, then point your agent at that folder. The agent can find repeated preferences and turn them into a skill for writing plans, writing code, or reviewing code.

## Collect the feedback you want to reuse

Use feedback from any Plannotator workflow:

* plan reviews
* document annotations
* local code reviews
* pull request and merge request reviews

Completed document and code-review feedback can return to the active agent. Save the results you want to reuse in a local folder. Plan reviews can also save final decisions under `${PLANNOTATOR_DATA_DIR:-~/.plannotator}/plans/` when **Save plans** is enabled.

<Warning>
  Feedback may contain private plans, code, comments, file paths, and repository details. Keep the folder local unless you have reviewed its contents.
</Warning>

## Ask your agent to create a skill

Point the agent at your feedback folder and state what you want to improve:

```text theme={null}
Review the Plannotator feedback in <feedback-folder>.

Find preferences that appear across several reviews. Use them to create a
reusable skill for <writing better plans | writing better code | reviewing
code to my preferences>.

Cite the feedback behind each rule. Ignore one-off comments and old guidance.
Show me the proposed skill before you create or install it.
```

Use the same process to create separate skills for planning, coding, and code review. Separate skills keep each set of instructions focused on the task.

## Reuse the skill

Use the skill when you ask an agent to plan, write code, or review changes. If your agent supports hooks, commands, or scheduled jobs, you can also run the skill through those tools.

Review the skill as your preferences change. Remove rules that no longer match your work, and add new rules only when the feedback supports them.

Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.