skill-checker

Validate AI skill definitions and generate check reports from SKILL.md files.

2|1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/GACLove/feishu-aily-skills --skill skill-checker-gaclove
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-checker
Source: https://github.com/GACLove/feishu-aily-skills/tree/main/skills/skill-checker
Command: npx skills add https://github.com/GACLove/feishu-aily-skills --skill skill-checker-gaclove

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Many AI agents fail to trigger the appropriate skill or encounter environment mismatches, leading to wasted time and incorrect results. This skill provides an automated way to validate, test, and refine other skill definitions to ensure reliable activation and compatible execution.

Core Features & Use Cases

  • Frontmatter validation: Automatically checks and fixes required fields in a skill’s SKILL.md.
  • Trigger test generation: Creates balanced query sets to evaluate whether the description correctly triggers the skill.
  • Environment scanning: Analyzes tool, capability, and service dependencies for compatibility with the current agent.
  • Report synthesis: Produces a single {skill_name}.check.json summarizing trigger accuracy, environment fitness, and optimization suggestions.
  • Optimization loop: Iteratively improves the skill’s description and adapts it to the execution environment.

Quick Start

Ask the skill-checker to evaluate the skill named "my-skill".

Frequently Asked Questions about skill-checker

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

FAQPage Schema
How do I validate AI skill triggers and fix frontmatter mismatches?

To validate AI skill triggers, you must check the SKILL.md frontmatter for required fields and generate test queries. This skill automates frontmatter validation and trigger testing to ensure correct activation and environment compatibility.

What is skill trigger testing and how does query generation work?

Skill trigger testing evaluates whether an AI description correctly activates a skill. It works by generating a balanced query set to challenge the skill's boundaries and synthesizing a report on trigger accuracy.

How do I test my AI agent's environment dependencies for skill execution?

You can test environment dependencies by scanning the agent's available tools and capabilities against the skill's requirements. This skill performs environment scanning to detect mismatches and verify execution compatibility.

Does skill validation require specific file formats or agent tools?

Skill validation requires access to the target skill's SKILL.md file. It also relies on the agent's internal validation, map, and scoring tools to evaluate trigger accuracy and synthesize the final check report.

Why does my AI skill fail to trigger correctly during execution?

AI skills fail to trigger correctly due to incomplete frontmatter, poor description mapping, or environment mismatches. This skill identifies these specific issues by running an optimization loop and testing balanced query sets.

What is the best way to optimize an AI skill description for reliable activation?

The best way to optimize an AI skill description is through iterative trigger testing. This skill refines the description by generating test queries, evaluating accuracy, and producing optimization suggestions in a check report.