write-a-skill

Create SKILL.md files with standardized frontmatter and core instructions.

2|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/MomoDaviluke/star-citizen-promotion --skill write-a-skill-momodaviluke
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/MomoDaviluke/star-citizen-promotion/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/MomoDaviluke/star-citizen-promotion --skill write-a-skill-momodaviluke

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users to craft well-structured, reusable AI skills by enforcing consistent frontmatter, documentation, and optional resources, ensuring clarity and reusability across projects.

Core Features & Use Cases

  • Establishes a standard skill layout (SKILL.md, optional REFERENCE.md, EXAMPLES.md, and scripts/ when needed)
  • Provides a reusable template and description conventions to enable quick discovery and loading
  • Supports optional resource directories for deterministic tasks and reference material
  • Useful for teams building a library of AI skills with consistent quality

Quick Start

Draft the SKILL.md with concise frontmatter and core instructions, and add optional references or scripts if the content requires them.

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 an AI skill with consistent frontmatter and documentation?

To structure an AI skill with consistent documentation, draft a SKILL.md file containing standardized YAML frontmatter and core instructions, adding optional reference files or scripts if content exceeds a single file.

What is the standard layout for creating reusable AI skills across projects?

The standard layout for reusable AI skills uses a primary SKILL.md file for frontmatter and instructions, supported by optional REFERENCE.md, EXAMPLES.md, and a scripts directory for deterministic tasks or extended material.

How do I write a skill description format that enables quick discovery and loading?

To write a skill description for quick discovery, format the content using three bolded section titles alongside a single Quick Start sentence to ensure standardized, clear loading across team projects.

When do I need to add optional references or scripts to my SKILL.md?

You need to add optional references or scripts to your SKILL.md when the skill content exceeds a single file, requiring supplementary reference material or scripts for deterministic task execution.

Can I use this approach to build a team library of AI skills with consistent quality?

Yes, you can use this skill standardization approach to build a team library of AI skills, enforcing reusable templates and consistent frontmatter documentation to maintain uniform quality across projects.