warning-example

{content} {content} {content} {content} {content} {content} {content} {content} {content}

Updated Aug 23, 2026

Search Tags:#documentation #quality #warnings #skill #validate #lint #frontmatter

Ready to run

npx skills add https://github.com/intent-solutions-io/create-agent-skill-md --skill warning-example

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: warning-example
Source: https://github.com/intent-solutions-io/create-agent-skill-md/tree/main/examples/warning-skill
Command: npx skills add https://github.com/intent-solutions-io/create-agent-skill-md --skill warning-example

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill definitions often miss quality cues, leading to inconsistent or weak skill implementations.

Core Features & Use Cases

Quality detection: identifies missing required fields and weak descriptions in SKILL.md.
Guidance for remediation: provides actionable warnings to improve skill definitions and documentation.
Use Case: ideal during skill creation, review, and ongoing maintenance to ensure baseline quality.

Quick Start

Run skill validate on the skill directory to surface quality warnings.

Frequently Asked Questions about warning-example

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

FAQPage Schema

How do I validate skill documentation quality in SKILL.md?▼

To validate skill documentation, run a validation check on your skill directory to surface quality warnings. It analyzes the SKILL.md frontmatter and body to identify missing required fields, weak descriptions, and naming inconsistencies.

What common frontmatter issues cause weak skill definitions?▼

Weak skill definitions often stem from missing required fields like name and description in the frontmatter. Validation flags these common quality issues, along with naming inconsistencies across skills, to ensure baseline documentation standards.

How do I check for missing required sections in skill definitions?▼

You can check for missing required sections by running a validation command against the skill directory. It scans the SKILL.md body and frontmatter to detect absent required sections and provides actionable warnings for remediation.

Does skill validation check naming consistency across multiple files?▼

Yes, skill validation includes checking naming consistency across skills. By analyzing the SKILL.md definitions, it identifies inconsistencies and provides actionable warnings to help you improve skill definitions and documentation.

When do I need to run a lint check on skill frontmatter?▼

You need to run a lint check during skill creation, review, and ongoing maintenance. Validating the frontmatter ensures that a valid Skill has a name and description, preventing inconsistent or weak skill implementations.

What is the best way to fix quality gaps in skill metadata?▼

The best way to fix quality gaps is to validate the skill directory to surface warnings, then follow the provided actionable guidance for remediation. This ensures your SKILL.md frontmatter and body meet required quality standards.