workflow-improve-skill

Name: workflow-improve-skill
Availability: InStock
Author: TinNguyen

Coordinate parallel audit agents to score SKILL.md against a rubric and generate prioritized improvement plans.

1|Updated Jan 26, 2026

Search Tags:#documentation #workflows #frontmatter #improve #skill-audit #quality-rubric

Ready to run

npx skills add https://github.com/AskTinNguyen/vesper-team-skills --skill workflow-improve-skill

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: workflow-improve-skill
Source: https://github.com/AskTinNguyen/vesper-team-skills/tree/main/workflow-improve-skill
Command: npx skills add https://github.com/AskTinNguyen/vesper-team-skills --skill workflow-improve-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Streamlines maintenance of Skill definitions by providing a structured, parallel-audit workflow that scores SKILL.md against a weighted rubric and surfaces concrete improvement plans.

Core Features & Use Cases

Parallel audit with multiple lenses (structure, clarity, accuracy, actionability, consistency, freshness) and a composite 100-point rubric.
Prioritized, approval-driven improvements that preserve the Skill's voice and intent.
Cross-file governance with references, workflows, and scripts to support safe changes.
Use cases include refreshing aging SKILL.md, planning gradual quality improvements, and validating new skill additions.

Quick Start

Trigger an improvement cycle on a target skill to generate baseline scores, propose changes, and apply approved edits.

Frequently Asked Questions about workflow-improve-skill

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

FAQPage Schema

How do I audit and improve SKILL.md documentation quality?▼

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.

What is the best way to score Skill metadata against a quality rubric?▼

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.

How do I maintain cross-file consistency when updating Skill frontmatter?▼

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.

Can I trigger an automated improvement cycle for aging documentation?▼

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.

Does the Skill audit process preserve the original author's voice?▼

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.

What are the limitations of using parallel audit agents for documentation?▼

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.