enhance-skills

Analyze SKILL.md files and report quality issues with optional auto-fixes.

951|110|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/agent-sh/agentsys --skill enhance-skills-agent-sh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: enhance-skills
Source: https://github.com/agent-sh/agentsys/tree/main/.kiro/skills/enhance-skills
Command: npx skills add https://github.com/agent-sh/agentsys --skill enhance-skills-agent-sh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews and improves the quality and structure of SKILL.md definitions to boost discoverability and correct usage.

Core Features & Use Cases

  • Discovers SKILL.md frontmatter and content to validate structure.
  • Checks required fields (name, description) and recommended fields (version, argument-hint, allowed-tools).
  • Evaluates trigger phrases, invocation controls, and security considerations; provides actionable recommendations.
  • Generates a concise quality report and optional auto-fixes.

Quick Start

Run enhance-skills to scan all SKILL.md files and generate a quality analysis report, optionally with --fix to auto-correct issues.

Frequently Asked Questions about enhance-skills

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

FAQPage Schema
How do I validate SKILL.md frontmatter and structure?

You validate SKILL.md frontmatter and structure by running an automated scan that checks required fields like name and description, evaluates trigger phrases, and generates an actionable quality report.

What are the required fields in a SKILL.md file?

The required fields in a SKILL.md file are name and description, while recommended fields include version, argument-hint, and allowed-tools to ensure proper invocation controls and discoverability.

Can I automatically fix missing metadata in skill definitions?

Yes, you can automatically fix missing metadata in skill definitions by running the scan with the --fix option, which corrects structural issues and populates missing frontmatter fields to improve quality.

What is a skill definition quality report?

A skill definition quality report is a concise analysis that identifies issues in SKILL.md files by validating frontmatter, checking naming conventions, evaluating description length, and reviewing trigger phrase effectiveness.

How do I check trigger phrases and security controls in SKILL.md files?

You check trigger phrases and security controls in SKILL.md files by running a validation scan that evaluates invocation controls and safety considerations, then provides actionable recommendations for structural improvements.

Why does my skill definition fail quality validation?

Your skill definition fails quality validation when it lacks required frontmatter fields like name or description, contains poorly structured trigger phrases, or misses critical invocation and safety controls.