lint-agents

Validate YAML frontmatter in agent Markdown files with line references.

8|3|Updated Jun 1, 2025
One-click install
npx skills add https://github.com/jonhill90/vibes --skill lint-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lint-agents
Source: https://github.com/jonhill90/vibes/tree/main/.github/skills/lint-agents
Command: npx skills add https://github.com/jonhill90/vibes --skill lint-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate agent definition files for correct YAML frontmatter syntax, catching common errors before they cause runtime failures.

Core Features & Use Cases

  • Frontmatter validation: ensures required fields like name and description are present.
  • YAML array checks: validates tools, disallowedTools, and skills are proper YAML arrays when provided.
  • Contextual guidance: surfaces violations with line references to help editors fix issues quickly.

Quick Start

Run the lint-agents check to validate all agent Markdown files and surface YAML frontmatter issues.

Frequently Asked Questions about lint-agents

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

FAQPage Schema
How do I validate YAML frontmatter in agent Markdown files?

To validate YAML frontmatter in agent Markdown files, run the lint-agents check across .github/agents and .claude/agents directories to ensure required fields like name and description are present and properly formatted.

What YAML fields are required in agent definition files?

Required YAML fields in agent definition files are name and description. Optional fields include tools, disallowedTools, and skills, which must be properly formatted as YAML arrays when provided.

Why does my agent definition fail at runtime with a frontmatter error?

Agent definitions fail at runtime when YAML frontmatter contains syntax errors or missing required fields. Linting catches these common errors early by validating fields like name and description before deployment.

Can I check agent definitions under .claude/agents and .github/agents?

Yes, you can check agent definitions under both .claude/agents and .github/agents directories. The linter validates all agent Markdown files in these locations for correct YAML frontmatter syntax.

Does the linter enforce allowed values for the model field in agent frontmatter?

Yes, the linter enforces allowed values for the model field when it is present in agent frontmatter. It reports violations with precise line references to help editors fix issues quickly.

How do I fix YAML array errors for tools and skills in agent files?

To fix YAML array errors for tools and skills in agent files, ensure these optional fields are formatted as proper YAML arrays. The linter surfaces violations with line references to guide corrections.