refine

Distill session learnings into concise, actionable updates to project documentation.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/jbro/pi-agent --skill refine-jbro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/jbro/pi-agent/tree/main/skills/project-docs/refine
Command: npx skills add https://github.com/jbro/pi-agent --skill refine-jbro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill turns session outcomes, decisions, and discovered patterns into concise, actionable updates to a project's docs/ so knowledge is preserved and documentation remains accurate.

Core Features & Use Cases

  • Session-to-docs distillation: review changes made and decisions taken during a session and map them to existing documentation.
  • Targeted edits and proposals: identify exact files to update, draft small surgical edits, and propose new files or structural changes before creating them.
  • Apply and report: after approval, apply approved changes and report updated file paths with a short summary; use the writing-clearly-and-concisely skill for final prose quality.

Quick Start

Ask the skill to refine project docs by summarizing this session's changes, proposing specific file edits, and applying approved updates.

Frequently Asked Questions about refine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update project documentation after a development session?

To update project documentation after a development session, distill session learnings and decisions into concise, actionable edits for files in docs/. The skill reviews recent changes and maps them to existing documentation.

What is the best way to distill session learnings into technical docs?

The best way to distill session learnings into technical docs is to review change lists, identify exact files to update, and draft small surgical edits. New files or structural changes are proposed conservatively before creation.

Does this documentation editing tool require approval before creating new files?

Yes, this documentation editing tool requires approval before creating new files or applying structural changes. It proposes targeted edits conservatively and reports updated file paths with short summaries after changes are approved.

Can I use this skill to propose structural changes to my docs directory?

Yes, you can use this skill to propose structural changes to your docs directory. It identifies necessary updates, drafts focused edits, and requests approval before creating new files or altering the existing documentation structure.

How does session-to-docs distillation handle recent code changes?

Session-to-docs distillation handles recent code changes by reading recent session notes or change lists to identify affected files in docs/. It then drafts focused, surgical edits to ensure documentation accurately reflects the discovered patterns and outcomes.

When should I use a project docs refinement tool versus manual editing?

You should use a project docs refinement tool versus manual editing when a development, planning, or review session concludes and you need to surgically map session outcomes, decisions, and discovered patterns into existing technical documentation.