Skill Review Readiness

Status: Experimental

This proposed skill helps the team review new or changed agent skills before they are promoted or broadly installed.

Purpose

The Skills library needs lightweight governance as more workflows are added. This skill gives reviewers a repeatable way to check trigger clarity, safety guardrails, install guidance, status consistency, examples, validation, and secret risk.

When To Use

• "Review this proposed skill before I submit it."
• "Is this skill ready for Team Review?"
• "Check this skills PR for placeholders, safety gaps, and missing docs."

Requirements

• The proposed skill folder and changed docs.
• Current contribution policy and status expectations.
• Any dry-run evidence or example prompts supplied by the author.

Install

Install only for intentional trial while this skill is Experimental:

scripts/install-skill.sh skill-review-readiness copilot /path/to/project-repo
scripts/install-skill.sh skill-review-readiness codex
scripts/install-skill.sh skill-review-readiness cursor /path/to/project-repo

Typical Output

• Findings ordered by severity.
• Status consistency check across the skill README and root README.
• Missing validation or dry-run scenarios.
• Promotion recommendation and concrete follow-up edits.

Testing

• Dry-run against a complete skill and confirm it identifies status, trigger, and validation evidence.
• Dry-run against a skill with placeholders and confirm it blocks promotion.
• Dry-run against a skill that performs external writes and confirm it requires explicit confirmation steps.

Example Prompt

Use the skill review readiness skill to review this proposed skill folder and tell me whether it is ready for Team Review.