clavix-refine

Load and modify existing PRDs or prompts with change tracking.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/mbed92/phd --skill clavix-refine-mbed92
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clavix-refine
Source: https://github.com/mbed92/phd/tree/main/.skills/clavix-refine
Command: npx skills add https://github.com/mbed92/phd --skill clavix-refine-mbed92

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of updating and enhancing existing Product Requirement Documents (PRDs) or saved prompts, preventing the need to start from scratch and ensuring continuous improvement.

Core Features & Use Cases

  • Content Discovery: Locates existing PRDs and saved prompts within the .clavix/outputs/ directory.
  • Interactive Selection: Allows users to choose which specific PRD or prompt they wish to refine.
  • State Loading & Modification: Loads the current content of the selected item and facilitates guided changes (additions, modifications, removals).
  • Change Tracking: Explicitly marks all changes made using [ADDED], [MODIFIED], [REMOVED], [UNCHANGED].
  • History Logging: Appends a detailed refinement history to the document.
  • Task Impact Warning: Alerts users if changes to a PRD might affect existing tasks and suggests regeneration.
  • Prompt Quality Improvement: Enhances prompts based on clarity, specificity, and completeness, showing before/after comparisons.

Quick Start

Use the clavix-refine skill to update your user-auth PRD.

Frequently Asked Questions about clavix-refine

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

FAQPage Schema
How do I refine an existing PRD without starting from scratch?

PRD refinement involves loading existing content and applying user-guided modifications. Changes are explicitly tracked using historical annotations to ensure continuous improvement without starting over.

How do I track changes when iteratively updating product requirement documents?

Iteratively updating product requirement documents tracks changes by explicitly marking all additions, modifications, and removals using tags like [ADDED], [MODIFIED], and [REMOVED], appending a detailed refinement history to the file.

Can I improve AI prompt quality and see before and after comparisons?

Yes, AI prompt quality is improved by evaluating clarity, specificity, and completeness. The system enhances the prompt and displays before and after comparisons to visualize the iterative improvements.

How do I know if modifying a PRD will impact existing tasks?

To know if modifying a PRD impacts existing tasks, the system provides task impact warnings. It alerts users if changes affect current tasks and suggests regeneration to maintain project alignment.

Where are my saved prompts and PRDs loaded from for iterative development?

Saved prompts and PRDs for iterative development are loaded from the `.clavix/outputs/` directory. The system locates existing content there and allows interactive selection of specific files to refine.