skill-reviser

Audit existing skills for framing, validation, and portability issues.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/niboj/agent-skills-12-factor-app --skill skill-reviser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-reviser
Source: https://github.com/niboj/agent-skills-12-factor-app/tree/main/skills/skill-reviser
Command: npx skills add https://github.com/niboj/agent-skills-12-factor-app --skill skill-reviser

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Reviser identifies and documents issues in an existing skill, including misframing, weak descriptions, vague instructions, missing validation, redundant files, and portability risks, then proposes concrete improvements.

Core Features & Use Cases

  • Structured frontmatter and scope review.
  • Actionable improvement recommendations for maintainability and portability.
  • Cross-skill comparison to identify overlaps and gaps.

Quick Start

Provide a concise review of a given skill, identifying framing flaws and proposing concrete improvements.

Frequently Asked Questions about skill-reviser

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

FAQPage Schema
How do I review existing skills for portability risks and weak descriptions?

Review existing skills by auditing frontmatter quality, identifying framing flaws, and checking validation loops to produce actionable improvement recommendations for maintainability and portability.

What issues should a skill documentation validation process look for?

A skill documentation validation process should look for misframing, vague instructions, missing validation loops, redundant files, and portability risks, then propose concrete improvements to fix them.

How do I identify overlapping scope between neighboring skills?

Identify overlapping scope by comparing neighboring skill artefacts to detect gaps and redundancies, enforcing review scope boundaries and ensuring references and assets are justified.

Can I use automated checks to enforce frontmatter quality during a skill review?

Yes, you can enforce frontmatter quality during a skill review by validating metadata fields, checking review scope, and ensuring all references, scripts, and assets are justified.

What is the best way to improve skill maintainability after deployment?

Improve skill maintainability after deployment by conducting a structured frontmatter and scope review, identifying redundant files, and applying actionable improvement recommendations to reduce portability risks.

Why does my skill review fail to catch portability risks and missing validation?

A skill review fails to catch portability risks and missing validation when it lacks structured frontmatter enforcement, scope boundaries, and validation loops, preventing the justification of references and scripts.