effective-agent-skills

Name: effective-agent-skills
Availability: InStock
Author: matymatyk-business

Define SKILL.md structure, frontmatter, and validation criteria for agent skills.

61|11|Updated Jun 15, 2026

Search Tags:#validation #best-practices #skill #frontmatter #agent-skills #skill-md

Ready to run

npx skills add https://github.com/Matymatyk-business/david-skills --skill effective-agent-skills

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: effective-agent-skills
Source: https://github.com/Matymatyk-business/david-skills/tree/main/skills/effective-agent-skills
Command: npx skills add https://github.com/Matymatyk-business/david-skills --skill effective-agent-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide clarifies how to write effective agent skills, detailing the anatomy of SKILL.md, frontmatter constraints, and best practices to ensure reliable routing, execution, and security.

Core Features & Use Cases

Provides a canonical structure for Skill Units (name, description, body) plus optional scripts, references, and assets.
Outlines patterns (Capability primitives vs Process primitives) and recommended workflows for writing, testing, and validating SKILL.md.
Serves as a reference for authors, reviewers, and automation tools to audit and generate new skills.

Quick Start

Review this guide to learn how to write and evaluate SKILL.md files for new skills.

Frequently Asked Questions about effective-agent-skills

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

FAQPage Schema

What is an agent skill and when do I need to write a SKILL.md file?▼

An agent skill is a discrete capability or process primitive executed by an AI. You need to write a SKILL.md file when packaging instructions, scripts, and metadata to enable reliable routing, execution, and semantic search indexing for automation.

How do I write effective agent skills with proper frontmatter validation?▼

To write effective agent skills, structure the SKILL.md with mandatory frontmatter constraints and lean body instructions. Validate the metadata fields against standard criteria and run safety checks to ensure proper semantic search discovery and secure execution.

What metadata fields are required in SKILL.md frontmatter for semantic search indexing?▼

Required SKILL.md frontmatter fields for semantic search indexing include the skill name, description, and specific metadata tags. These fields define the standard structure necessary for automation tools to discover, audit, and route the skill accurately.

Does writing agent skills require defining dependencies and components?▼

Defining dependencies and components is required when your agent skill relies on external scripts, references, or assets. Determining these elements during authoring ensures the skill has the necessary environment setup and tool components to execute its workflows reliably.

What is the best way to structure SKILL.md body instructions for AI agents?▼

The best way to structure the SKILL.md body is using lean instructions and recommended workflows that clearly define capability or process primitives. This canonical structure prevents ambiguity, ensuring the agent executes the task safely and as intended.

Why does my agent skill fail validation during semantic indexing?▼

Agent skill validation fails when the SKILL.md lacks mandatory frontmatter, contains incomplete metadata fields, or misses required safety checks. Review the canonical structure constraints and ensure all dependencies and components are properly declared to pass audit.