utility-pm-skill-iterate

Applies targeted edits to existing pm-skills skills with preview, confirmation, and version bump guidance.

640|81|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-pm-skill-iterate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: utility-pm-skill-iterate
Source: https://github.com/product-on-purpose/pm-skills/tree/main/skills/utility-pm-skill-iterate
Command: npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-pm-skill-iterate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Improving an existing pm-skills skill after validation findings or feedback requires careful, reviewable edits across SKILL.md, templates, and examples, plus correct version and history bookkeeping. This Skill turns that into a controlled workflow: it reads the current files, normalizes your input into an intended-changes list, previews before/after edits, and only writes after your confirmation.

Core Features & Use Cases

  • Multi-input iteration: Accepts a validation report from utility-pm-skill-validate, direct feedback, convention changes, or general improvement requests, and normalizes them into a structured change list.
  • Safe editing workflow: Shows before/after previews grouped by file, requires explicit confirmation, and re-reads files before writing to guard against stale previews.
  • Version governance: Suggests a SemVer bump class (patch/minor/major) with reasoning and manages HISTORY.md creation or updates according to defined rules.
  • Use Case: After running a validation report on the deliver-prd skill that flags a vague output contract, use this Skill to preview the fix, apply it, bump the version from 2.0.0 to 2.0.1, and create HISTORY.md.

Quick Start

Apply the fixes recommended in this validation report to the deliver-prd skill and suggest the appropriate version bump.

Frequently Asked Questions about utility-pm-skill-iterate

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

FAQPage Schema
How do I apply fixes from a skill validation report?

Pass the validation report from utility-pm-skill-validate to this Skill along with the target skill name. It parses the Recommendations section, builds an intended-changes list, previews each edit, and writes only after your confirmation.

How do I update a pm-skills skill after a convention change?

Describe the convention change and name the target skill, for example adding a Limitations section. The Skill maps the change to specific files and sections, shows before/after previews, and applies the edit on confirmation.

When should I use skill iteration versus skill validation?

Run utility-pm-skill-validate first to audit a skill and produce findings, then use this Skill to apply the recommended changes. Iteration is for editing; validation is for auditing without modifying files.

Does the iteration skill change version numbers automatically?

No. It suggests a SemVer bump class (patch, minor, or major) with reasoning based on whether the change clarifies, adds optional capability, or breaks the required contract. The version is written only after you explicitly confirm.

What happens if skill files change between preview and writing?

A stale-preview guard re-reads each target file before writing and compares it to the content recorded earlier. If anything changed, no files are written and the preview is regenerated from the current content.

When is HISTORY.md created for a skill?

HISTORY.md is created only when a skill ships its second version, with entries for both versions. It is not created for a first-version skill, and existing files are format-validated before appending new entries.