workflow-improve-skill

To audit SKILL.md quality, coordinate parallel agents to score structure, actionability, and consistency against a 100-point rubric, generating a prioritized improvement plan with gate-based approvals before applying edits.

Scoring Skill metadata involves applying a weighted 100-point rubric across multiple lenses like clarity, accuracy, and freshness, then using explicit approvals to apply prioritized improvements and re-score to verify gains.

Maintaining cross-file consistency requires auditing SKILL.md alongside related references and workflows, ensuring safe changes through gate-based approvals before propagating updates to connected files.

Yes, you can trigger an improvement cycle on target documentation to generate baseline scores, propose changes, and apply approved edits, streamlining maintenance and refreshing aging files.

The audit process preserves the original voice by using approval-driven improvements, ensuring proposed changes target structure and actionability without altering the Skill's fundamental intent.

Parallel audit agents require explicit gate-based approvals before edits, meaning changes are paused for user validation, which may slow down rapid manual edits but ensures safe, structured improvements.