plsfix

Rewrite vague instruction documents into clear specifications with a change report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts vague, ambiguous, or poorly structured instruction documents into clear, actionable specifications so humans and AI can execute them reliably. It diagnoses structural and content failures, preserves author voice, and surfaces assumptions for confirmation.

Core Features & Use Cases

  • Diagnostic checklist: Runs a 12-principle audit (structure → content → delivery) to locate ambiguity, contradictions, and missing output contracts.
  • Rewrite + change report: Produces a rewritten document plus a change report that maps every edit to the principle it implements and explains why.
  • Safe assumptions & minimal edits: Marks inferred details with [CONFIRM] and avoids inventing scope, making it ideal for SKILL.md, system prompts, PRDs, runbooks, and reusable prompt templates.

Quick Start

Improve this instruction document for clarity and produce a rewritten version plus a change report.

Frequently Asked Questions about plsfix

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

FAQPage Schema
How do I turn vague product requirements into clear, actionable specs for AI and humans?

To turn vague product requirements into clear specs, this Skill rewrites ambiguous instruction documents into actionable specifications and generates a change report mapping every edit to one of twelve clarity principles.

Why does my system prompt or SKILL.md file keep getting misinterpreted by AI?

Your system prompt or SKILL.md gets misinterpreted by AI due to missing output contracts, structural ambiguity, or contradictory instructions. This Skill diagnoses these failures using a 12-principle audit and rewrites the document for reliable execution.

How do I clarify a runbook or brief without inventing new scope or changing the author's voice?

To clarify a runbook or brief without inventing scope, this Skill preserves the author's voice, makes minimal edits, and marks inferred details with [CONFIRM] so you can validate assumptions before execution.

Can I automatically rewrite a prompt template and track what content changed?

Yes, you can rewrite a prompt template and track changes. This Skill produces a rewritten document alongside a detailed change report that maps each structural and content edit to the specific principle it implements.

What is the best way to audit reusable prompt templates for structural and content failures?

The best way to audit reusable prompt templates for structural and content failures is to run a 12-principle diagnostic checklist that locates ambiguity, contradictions, and missing delivery contracts before rewriting.

Does improving instruction documents require defining output contracts and examples?

Yes, improving instruction documents requires defining output contracts and examples. This Skill ensures rewritten specifications include these delivery details so both humans and AI can execute the instructions reliably.