Creating Agent Skills

Generate SKILL.md content and templates with YAML frontmatter and progressive disclosure.

1|Updated Jun 4, 2025
One-click install
npx skills add https://github.com/kynoptic/markdownlint-trap --skill creating-agent-skills-kynoptic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Creating Agent Skills
Source: https://github.com/kynoptic/markdownlint-trap/tree/main/.claude/skills/creating-agent-skills
Command: npx skills add https://github.com/kynoptic/markdownlint-trap --skill creating-agent-skills-kynoptic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Crafting effective AI Agent Skills requires adherence to specific best practices for naming, structure, discovery, and conciseness. This Skill guides users through creating and improving skills to maximize their utility and discoverability, ensuring your AI agents perform optimally.

Core Features & Use Cases

  • Best Practice Adherence: Ensures skills follow official guidelines for gerund naming, third-person descriptions, progressive disclosure, and conciseness.
  • Structured Skill Creation: Guides through defining YAML frontmatter, structuring content, and organizing reference files for optimal agent performance.
  • Discovery & Testing: Provides strategies for writing effective descriptions that trigger skill discovery and methods for testing skill functionality with real scenarios.
  • Use Case: You have a complex internal process you want to automate with an AI agent. Use this Skill to structure the knowledge into a discoverable and actionable Agent Skill, complete with examples and troubleshooting.

Quick Start

Use the "Creating Agent Skills" skill to draft a new skill for managing cloud infrastructure, focusing on best practices for naming and description.

Frequently Asked Questions about Creating Agent Skills

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

FAQPage Schema
How do I structure an AI skill with proper naming and formatting?

Agent skills require gerund-form naming (e.g., 'Creating Agent Skills'), third-person descriptions, YAML frontmatter with name and description fields, and progressive disclosure layout. This structure ensures discoverability and consistent agent performance across domains.

What are the best practices for writing skill descriptions to improve discovery?

Write concise, domain-focused descriptions that clarify the skill's core task without time-sensitive content. Use one-level file references and avoid nested complexity. Effective descriptions trigger agent discovery by matching the specific problem users need solved.

Can I use this to convert existing processes into discoverable agent skills?

Yes. This skill guides you through restructuring complex internal processes—like cloud infrastructure automation—into compliant agent skills by applying best practices for naming, YAML frontmatter, progressive disclosure, and reference organization.

What documentation standards must agent skills follow?

Skills must enforce gerund naming, third-person descriptions, YAML frontmatter compliance, progressive disclosure layout, one-level file references, and domain-focused content without time-sensitive information to satisfy agent performance and discoverability requirements.

How do I test whether my skill will be discovered and used effectively?

Validate your skill against best practice guidelines: gerund naming, third-person descriptions, proper YAML structure, and concise domain focus. Test functionality with real scenarios matching the skill's core task to ensure agents trigger and execute it correctly.