skill-writer

Locate valid Skill Units and generate YAML metadata from SKILL.md frontmatter.

1|Updated Jul 15, 2025
One-click install
npx skills add https://github.com/marjan-ahmed/ustaz --skill skill-writer-marjan-ahmed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/marjan-ahmed/ustaz/tree/main/.claude/skills/skill-writer
Command: npx skills add https://github.com/marjan-ahmed/ustaz --skill skill-writer-marjan-ahmed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams create consistent, well-structured Agent Skill entries (SKILL.md) by providing clear templates, validation rules, and best practices.

Core Features & Use Cases

  • Provides a standardized workflow for drafting SKILL.md frontmatter and content
  • Guides structure, progressive disclosure, and validation checks to ensure discoverability
  • Assists in generating metadata for new skills and auditing existing ones

Quick Start

Ask clarifying questions about scope, then draft the SKILL.md frontmatter and overall skill structure.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I create a SKILL.md file with valid yaml frontmatter?

To create a valid SKILL.md file, draft the yaml frontmatter including required fields like name and description, then use this skill to validate the structure and generate missing metadata such as tagline, category, and keywords.

What is the required structure for a Claude Skill unit?

A Claude Skill unit requires a directory containing a SKILL.md file with valid yaml frontmatter. This skill identifies valid units by locating these directories and extracting the name and description fields for validation.

How do I validate skill metadata and check for missing fields?

You validate skill metadata by parsing the SKILL.md file to extract frontmatter and generate a YAML document containing fields like name, tagline, dependencies, components, and a safety assessment to ensure discoverability.

Can I generate a safety assessment for an existing skill unit?

Yes, you can generate a safety assessment for an existing skill unit. This skill extracts the name and description from the frontmatter and outputs an is_toxic field with a toxic_reason to flag potentially harmful content.

What's the best way to audit existing SKILL.md files for consistency?

The best way to audit existing SKILL.md files is to scan directories for valid skill units, extract their frontmatter, and generate a standardized YAML document per unit to verify metadata consistency and discoverability.

Do I need any dependencies to generate skill documentation?

No dependencies are required to generate skill documentation. This skill operates independently to extract frontmatter from SKILL.md files and output standardized metadata for validation and discoverability.