skills.rest
LiozShor
LiozShorCOMMUNITY
Explore all skills by this author →
GitHub

skill-improver

Review and refactor SKILL.md files for structure, permissions, and evaluation coverage.

2|Updated Jun 9, 2026
Search Tags:#audit#review#skill improvement#SKILL.md#agent skill
One-click install
npx skills add https://github.com/LiozShor/claude-code-skills --skill skill-improver-liozshor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/LiozShor/claude-code-skills/tree/main/skill-improver
Command: npx skills add https://github.com/LiozShor/claude-code-skills --skill skill-improver-liozshor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps improve the quality and reliability of existing agent skills, ensuring they are secure, clear, and efficient.

Core Features & Use Cases

  • Skill Review and Audit: Analyze SKILL.md files for structure, triggers, permissions, and other critical aspects.
  • Safety Modes: Operate in different modes like review-only, safe-edit, permission-changing, and structural-defect repair.
  • Workflow Improvement: Refactor workflows, add decision gates, and enhance output formats.
  • Permission Management: Classify and manage permissions for the skill, ensuring minimal and justified access.
  • Evaluation: Check the skill's evaluation coverage and ensure it meets quality standards.

Quick Start

Run the skill-improver to review and improve an existing skill. Provide the skill folder path and specify the mode of operation.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I audit an agent skill's SKILL.md file for structure and security?▼

To audit an agent skill, you review its SKILL.md file to analyze triggers, permissions, and structural integrity. This process identifies security vulnerabilities and ensures the skill design meets safety and quality standards.

What is the best way to refactor agent skill workflows to add decision gates?▼

The best way to refactor agent skill workflows is to systematically add decision gates and enhance output formats. This refactoring improves the skill's execution flow while maintaining strict safety and operational reliability.

Can I review and change permissions for an agent skill without breaking it?▼

Yes, you can change permissions using safe-edit or permission-changing modes. These modes classify and manage access rights to ensure the agent skill has minimal, justified permissions without breaking its core functionality.

How do I check if my agent skill has enough evaluation coverage?▼

You check evaluation coverage by running an audit on the agent skill. This verification process ensures the skill's tests and evaluation metrics meet quality standards and adequately cover its operational triggers.

What modes are available for repairing structural defects in a SKILL.md file?▼

Available modes for repairing structural defects include review-only, safe-edit, and structural-defect repair modes. These modes allow you to safely fix issues in the SKILL.md file with varying levels of modification permission.

Related Skills

Explore More Software Engineering Skills→
SempriniSemprini
1

baseline-capture

Document existing data assets as MD-DDL baseline files.

Community
Intermediate
jayhjenkinsjayhjenkins

receiving-code-review

Restate code review feedback and verify against the repository before implementing changes.

Community
Basic
venomez-vipervenomez-viper
1

tdd-refactor-guard

Verify test coverage and generate characterization tests before refactoring code.

Community
Advanced
ze-softwareze-software
50

ze-review

Identify defects and gaps in Ze repository changes and report findings.

Official
Advanced