write-a-skill

Guide creation of new agent skills with structured templates and best practices.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mnadalc/dotfiles --skill write-a-skill-mnadalc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/mnadalc/dotfiles/tree/main/.ai/skills/write-a-skill
Command: npx skills add https://github.com/mnadalc/dotfiles --skill write-a-skill-mnadalc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured process and template for creating new agent skills, ensuring they are well-defined, discoverable, and maintainable.

Core Features & Use Cases

  • Skill Creation Guidance: Offers a step-by-step process for gathering requirements, drafting skill content, and reviewing with users.
  • Standardized Structure: Defines the recommended directory structure and file templates for new skills (SKILL.md, REFERENCE.md, scripts/).
  • Best Practices: Provides guidelines on writing effective SKILL.md descriptions, deciding when to add scripts, and when to split files.
  • Use Case: A developer needs to create a new skill to manage user authentication. They would use this skill to guide them through defining the skill's name, description, and any necessary scripts or reference materials.

Quick Start

Use the write-a-skill skill to create a new skill for managing user authentication.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema
How do I structure a new agent skill for maintainability?

To structure a new agent skill, use a standardized directory layout with a `SKILL.md` file for descriptions, a `REFERENCE.md` for resources, and a `scripts/` folder for modularization.

What is the process for developing agent skills from requirements?

Developing agent skills involves a structured process of gathering requirements, drafting the skill content, reviewing it with users, and organizing the necessary scripts and reference materials.

When should I split files or add scripts to an agent skill?

You should split files or add scripts to an agent skill when the content becomes too complex for a single `SKILL.md` file, following established best practices for maintainability and modularity.

What's the best way to write effective SKILL.md descriptions?

Writing effective `SKILL.md` descriptions requires defining the problem the skill solves, detailing core features and use cases, and providing a quick start guide to ensure the skill is discoverable.

Does this skill creation template support user authentication workflows?

Yes, the skill creation template supports user authentication workflows by guiding you through defining the skill's name, description, and any necessary scripts or reference materials for that use case.

Can I use this approach to create skills without writing custom scripts?

Yes, you can create skills without custom scripts if the task relies purely on prompt engineering and documentation, as the guidelines help decide exactly when script integration is necessary.