skills.rest
sergiodxa
sergiodxaCOMMUNITY
Explore all skills by this author →
Website𝕏@sergiodxaGitHub

skill-writing-best-practices

Define directory structure and SKILL.md content guidelines for AI agent skills.

93|9|Updated Jan 27, 2026
Search Tags:#developer tools#best practices#documentation#AI agent#skill writing#coding patterns
One-click install
npx skills add https://github.com/sergiodxa/agent-skills --skill skill-writing-best-practices
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writing-best-practices
Source: https://github.com/sergiodxa/agent-skills/tree/main/skills/skill-writing-best-practices
Command: npx skills add https://github.com/sergiodxa/agent-skills --skill skill-writing-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides clear guidelines and patterns for creating high-quality AI agent skills, ensuring consistency, clarity, and effectiveness in skill development.

Core Features & Use Cases

  • Skill Structure: Defines the optimal directory and file organization for skills.
  • Content Guidelines: Outlines best practices for writing SKILL.md and individual rule files, focusing on clarity, reasoning, and actionable advice.
  • Use Case: When developing a new skill, consult these best practices to ensure it follows established patterns for discoverability and usability by AI agents.

Quick Start

Use the skill-writing-best-practices skill to review the structure of a new skill file.

Frequently Asked Questions about skill-writing-best-practices

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

FAQPage Schema
How do I write effective AI agent skills?▼

Effective AI agent skills require a clear directory structure, well-formatted SKILL.md files, and rule files with concrete examples and reasoning to ensure discoverability and actionable agent responses.

What should be included in a SKILL.md file?▼

A SKILL.md file should include clear guidelines, concrete examples, and reasoning to maintain a natural writing style, ensuring the skill is actionable and scalable for AI agents.

How do I structure files and directories for AI agent skills?▼

Structure AI agent skills by organizing files into an optimal directory layout that separates the SKILL.md file from individual rule files, ensuring the skill is scalable and discoverable.

What are the best practices for formatting individual rule files in AI skills?▼

Best practices for formatting individual rule files involve using a natural writing style, providing concrete examples, and explaining the reasoning behind coding patterns to guide AI agents effectively.

Why do my AI agent skills fail to trigger or scale correctly?▼

AI agent skills may fail to scale or trigger correctly if they lack proper directory structure, clear SKILL.md content, or actionable formatting patterns, reducing their discoverability and effectiveness.

Related Skills

Explore More Software Engineering Skills→
telum-aitelum-ai
2

project-import

Create a Speck project structure with a skeleton project.md file.

Official
Basic
mobster570mobster570

agent-development

Generate and validate autonomous agent configurations for Claude Code plugins.

Community
Advanced
fyrsmithlabsfyrsmithlabs

git-repo-standards

Validate repository naming, structure, documentation, and security files against project standards.

Official
Intermediate
openxlingsopenxlings
599

xlings-docs-writing

Enforce Chinese academic-style documentation standards for the xlings project's docs directory.

Official
Intermediate