wz:writing-skills

Author and validate Skills using a canonical SKILL.md structure.

3|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/MohamedAbdallah-14/Wazir --skill wz-writing-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wz:writing-skills
Source: https://github.com/MohamedAbdallah-14/Wazir/tree/main/skills/writing-skills
Command: npx skills add https://github.com/MohamedAbdallah-14/Wazir --skill wz-writing-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing consistent, reusable skill guides is hard without a standardized template and validation process; this guide provides a canonical approach to author, structure, and verify Skill Units.

Core Features & Use Cases

  • Clear Skill Unit structure with a required SKILL.md frontmatter (name and description) and optional resources (scripts/, references/, assets/).
  • TDD-inspired workflow (RED-GREEN-REFACTOR) to ensure skills improve agent behavior and verifiability.
  • Guidance on writing prescriptive, actionable Skill content, including frontmatter, description, and quick-start instructions.

Quick Start

Draft a complete Skill Unit following the canonical SKILL.md format and provide a concrete example of the resulting metadata.

Frequently Asked Questions about wz:writing-skills

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

FAQPage Schema
How do I structure and validate reusable skill guides for agent workflows?

To structure and validate reusable skill guides, author a root SKILL.md file with YAML frontmatter including name and description, add optional resource directories, and apply a TDD-inspired workflow to verify behavior.

What is the test-driven documentation process for authoring skills?

The test-driven documentation process for authoring skills uses a RED-GREEN-REFACTOR workflow to ensure skill guides are prescriptive, actionable, and verifiably improve agent behavior before deployment across projects.

What files and directories are required when creating a new skill unit?

Creating a new skill unit requires a root SKILL.md file containing YAML frontmatter with name and description fields. Optional directories include scripts, references, and assets for supplementary resources.

How do I verify existing skills before deploying them across projects?

To verify existing skills before deployment, validate the SKILL.md structure and frontmatter, and apply the test-driven RED-GREEN-REFACTOR cycle to confirm the skill guide improves agent behavior.

What's the best way to write prescriptive and actionable skill content?

The best way to write prescriptive and actionable skill content is to follow a canonical SKILL.md format, define clear guidelines, and include quick-start instructions with concrete metadata examples.

When should I update an existing skill unit instead of creating a new one?

Update an existing skill unit when modifying prescriptive guidelines or resource directories, rather than creating a new one, ensuring the SKILL.md frontmatter remains valid and the TDD verification passes.