write-a-skill

Create structured AI skills with SKILL.md frontmatter and resource bundles.

1|Updated Apr 25, 2026

Search Tags:#skill creation #AI development #progressive disclosure #resource bundling #structured skills

Ready to run

npx skills add https://github.com/dariomazzitellireplik-coder/sdd-skills --skill write-a-skill-dariomazzitellireplik-coder

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/dariomazzitellireplik-coder/sdd-skills/tree/main/skills/write-a-skill
Command: npx skills add https://github.com/dariomazzitellireplik-coder/sdd-skills --skill write-a-skill-dariomazzitellireplik-coder

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill aids in the creation of structured agent skills with the right level of disclosure and resource inclusion. It streamlines the process for developing, writing, and organizing new skills, saving time and effort in skill design and documentation.

Core Features & Use Cases

Structured Skill Creation: Facilitates the setup of a well-organized skill with SKILL.md as the central document, ensuring clear guidance for skill creation.
Progressive Disclosure: Provides step-by-step guidance to users through skill creation, focusing on the most crucial elements first.
Resource Bundle: Guides on how to bundle scripts, reference files, and assets with the skill to make it ready-to-use.
Use Case: Ideal for those starting with a new skill project and require guidance on structure and best practices to build and maintain it.

Quick Start

To begin writing a new skill, follow these steps: Run /sdd-write-a-skill create my-skill and provide the necessary details.

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 AI skill for progressive disclosure?▼

Bundle scripts, reference files, and assets with your structured AI skill to make it ready-to-use. Organizing these resources alongside SKILL.md ensures the skill has proper documentation and all necessary components for maintainability.

What is the best way to create SKILL.md frontmatter for a new skill?▼

The best way to create SKILL.md frontmatter is to follow progressive disclosure guidance, setting up the file as the central document for your skill. This ensures proper documentation, clear structure, and ease of maintenance for developers and users.

Do I need to bundle scripts and assets when creating an AI skill?▼

Yes, you should bundle scripts, reference files, and assets when creating an AI skill. Bundling these resources ensures the skill is ready-to-use and properly structured, improving ease of use and maintainability for both skill users and developers.

How do I start writing a structured skill project from scratch?▼

To start writing a structured skill project from scratch, run the initialization command and provide the necessary details. This initiates the progressive disclosure process, guiding you through setting up SKILL.md and organizing associated files.

Can I use this to organize documentation for existing AI development projects?▼

Yes, you can use this to organize documentation for existing AI development projects by restructuring them around SKILL.md. It provides guidance on adding proper documentation, resource bundles, and structure to improve ease of use and maintainability.