skills-improve

Analyze and refactor AI skills by reading SKILL.md and criteria.md files.

Updated Feb 9, 2026

Search Tags:#skill development #prompt engineering #code refactoring #robustness #skill improvement #AI skill optimization

Ready to run

npx skills add https://github.com/lucadellanna/luca-skills --skill skills-improve

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skills-improve
Source: https://github.com/lucadellanna/luca-skills/tree/main/skills/skills-improve
Command: npx skills add https://github.com/lucadellanna/luca-skills --skill skills-improve

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires skills-review, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you identify and implement improvements for other AI skills, making them more effective, concise, and robust.

Core Features & Use Cases

Skill Analysis: Assesses skills against defined criteria for completeness, robustness, and clarity.
Targeted Implementation: Applies selected improvements, including code optimization and structural changes.
Use Case: You have a skill that's a bit wordy or occasionally misses edge cases. Use this skill to analyze it, get specific suggestions for improvement, and have the skill automatically update itself based on your choices.

Quick Start

Use the skills-improve skill to analyze and enhance the 'document-summarizer' skill.

Frequently Asked Questions about skills-improve

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

FAQPage Schema

How do I refactor an AI skill to improve its robustness and clarity?▼

To refactor an AI skill for robustness and clarity, analyze its SKILL.md and criteria.md files to assess completeness, then apply targeted structural changes and code optimization through a preview, backup, and verify safety model.

How does skill analysis against criteria.md work for optimizing prompts?▼

Skill analysis reads criteria.md to evaluate prompt definitions for edge cases and conciseness, identifying specific areas where structural changes or code optimization can enhance overall skill robustness and effectiveness.

Can I use this skill improvement process on both project-local and installed skills?▼

Yes, the skill improvement process supports both project-local and installed skills by reading their SKILL.md and relevant configuration files to assess and implement targeted enhancements regardless of the skill's installation location.

What is the best way to automatically update a wordy AI skill that misses edge cases?▼

The best way to update a wordy AI skill is to analyze it against defined criteria, receive specific suggestions for missed edge cases, and automatically apply selected improvements using a backup and verify safety model.

Do I need skills-review before analyzing and optimizing AI skills?▼

Yes, skills-review is a required dependency, meaning you must run the initial skill assessment through that prerequisite tool to generate the criteria and baseline data needed for targeted skill improvement.

What are the limitations when applying code refactoring to AI skills?▼

A key limitation is that code refactoring changes are not applied directly; they must pass through a preview, backup, apply, and verify safety model to ensure structural changes do not break the existing skill's logic.