What problem does it solve? Maintainers editing workflow skills under packages/pi-flow-core/skills risk breaking agent behavior, failing guardrail tests, or corrupting byte-exact strings that downstream parsers depend on. This Skill provides a safe, repeatable process for shortening and clarifying SKILL.md files while preserving behavior. ## Core Features & Use Cases - Pre-edit safety checks: Identify exact strings that must survive (menus, status codes, banners, handoff formats) and search tests for guardrail strings before changing wording. - Simplification rules: Concrete guidance on preserving gates, verification steps, and subagent boundaries while deleting redundant prose and merging repeated rules. - Safe rewrite process: Ordered steps for shrinking descriptions, restructuring headings, and moving detail into reference files one level deep. - Use Case: A maintainer wants to shorten a bloated workflow skill. Following this Skill, they grep tests for protected strings, rewrite the main path into scannable steps, then run pnpm --filter pi-flow-core run test:node to verify no behavior changed. ## Quick Start Ask the AI to simplify the SKILL.md for a specific pi-flow-core workflow skill while preserving all guardrail strings and running the package tests afterward.
