creating-new-skills

Guide creation of Agent Skills with SKILL.md structure and testing.

Updated Jan 18, 2026
One-click install
npx skills add https://github.com/mhmdsamir92/research-agent --skill creating-new-skills-mhmdsamir92
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-new-skills
Source: https://github.com/mhmdsamir92/research-agent/tree/main/.claude/skills/meta-skill
Command: npx skills add https://github.com/mhmdsamir92/research-agent --skill creating-new-skills-mhmdsamir92

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the creation of new Agent Skills for AI agents, ensuring they adhere to best practices and comprehensive documentation standards.

Core Features & Use Cases

  • Guided Skill Creation: Provides a step-by-step workflow for defining, structuring, and writing new skills.
  • Best Practice Enforcement: Guides users on naming conventions, frontmatter requirements, instruction clarity, and supporting file organization.
  • Use Case: A developer needs to create a new skill for their team to manage customer support tickets. They use this meta-skill to ensure the new skill is well-documented, discoverable, and follows established patterns.

Quick Start

Use the meta-skill to create a new skill for analyzing user feedback.

Frequently Asked Questions about creating-new-skills

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

FAQPage Schema
What are the best practices for AI agent skill creation?

AI agent skill creation best practices involve defining a clear purpose, structuring directories properly, designing SKILL.md files, writing clear instructions, creating examples, and testing thoroughly. This ensures skills are discoverable and well-documented.

How do I structure a new skill for an AI agent?

To structure a new skill for an AI agent, follow a step-by-step workflow covering purpose definition, directory structure, SKILL.md design, instruction writing, example creation, and testing. Proper frontmatter and naming conventions are enforced throughout.

Do I need any specific dependencies to build agent skills?

No specific dependencies are required to build agent skills. The process focuses on documentation standards, naming conventions, frontmatter requirements, and supporting file organization to ensure the generated skills integrate smoothly.

What's the best way to document AI agent workflow automation skills?

The best way to document workflow automation skills is by using a guided meta-skill that enforces frontmatter requirements, naming conventions, and supporting file organization. This ensures your team's custom skills remain discoverable and maintainable.

Can I use this to create a skill for managing customer support tickets?

Yes, you can create a skill for managing customer support tickets. The guided workflow ensures your new agent skill is well-documented, follows established patterns, and adheres to comprehensive documentation standards for team use.

Why does my agent skill fail to follow established patterns?

Agent skills fail to follow established patterns when they lack proper directory structure, clear SKILL.md design, or frontmatter requirements. Using a guided creation workflow enforces instruction clarity and supporting file organization to prevent this.