writing-skills

Create and update SKILL.md documentation with front matter and Markdown instructions.

8|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/dave1010/tools --skill writing-skills-dave1010
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/dave1010/tools/tree/main/.agents/skills/writing-skills
Command: npx skills add https://github.com/dave1010/tools --skill writing-skills-dave1010

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides clear guidelines and best practices for creating and updating SKILL.md files, ensuring consistent and effective documentation for AI skills.

Core Features & Use Cases

  • SKILL.md Structure: Explains the required front matter (name, description) and the purpose of the Markdown body.
  • Best Practices: Offers advice on naming conventions, description formatting, and concise instruction writing.
  • Use Case: When you need to create a new skill or refine the documentation for an existing one, consult this Skill for guidance on how to write an optimal SKILL.md file.

Quick Start

Use the writing-skills skill to learn how to write a good description for a SKILL.md file.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write a SKILL.md file for an AI skill?

To write a SKILL.md file, include the required front matter such as name and description, followed by a concise Markdown body with clear instructions to ensure discoverability and operational clarity for AI agents.

What are the best practices for AI skill documentation?

Best practices for AI skill documentation involve using proper naming conventions, formatting descriptions effectively, and writing concise instructions in the Markdown body to maintain operational clarity.

What front matter is required in a SKILL.md file?

The required front matter in a SKILL.md file includes the name and description fields, which are essential for defining the skill and ensuring its discoverability by AI agents.

How do I structure markdown instructions for AI agents?

Structure markdown instructions for AI agents by keeping the body concise and focused on operational clarity, ensuring the steps are direct and easy for the agent to parse and execute.

When should I update an existing SKILL.md file?

You should update an existing SKILL.md file when you need to refine its documentation, ensuring the description and instructions remain clear, concise, and aligned with current best practices for AI skills.

Does a SKILL.md file require YAML front matter?

Yes, a SKILL.md file requires YAML front matter containing at least the name and description fields to properly define the skill and ensure it is discoverable by AI agents.