writing-skills

Enforce YAML frontmatter validation and RED-GREEN-REFACTOR workflows for skill authoring.

Updated May 11, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/my-supremepowers --skill writing-skills-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/AvaTar-ArTs/my-supremepowers/tree/main/qwen_skills/superpowers-writing-skills
Command: npx skills add https://github.com/AvaTar-ArTs/my-supremepowers --skill writing-skills-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authors often ship skills that are under-specified, hard to validate, and difficult to audit. This guide provides a repeatable, test-driven approach to skill authoring that emphasizes a clear frontmatter contract and observable verification.

Core Features & Use Cases

  • Enforces RED-GREEN-REFACTOR workflow for skill authoring and validation.
  • Validates YAML frontmatter in SKILL.md (must include name and description) and captures a baseline verification plan.
  • Detects and inventories optional components (scripts, references, assets) for on-demand loading.
  • Provides structured Quick Start guidance to jump-start skill testing and deployment.

Quick Start

Draft the writing-skills SKILL.md with a clear name and description, specify the RED-GREEN-REFACTOR process, and include a basic validation baseline to verify the skill before deployment.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I validate YAML frontmatter in SKILL.md for reliable skill authoring?

To validate YAML frontmatter in SKILL.md, you must enforce requirements that include a clear name and description. This skill authoring process captures a baseline verification plan to ensure test-backed documentation accompanies each deployment.

What is the RED-GREEN-REFACTOR workflow for skill validation?

The RED-GREEN-REFACTOR workflow for skill validation is a test-driven approach that enforces baseline failures and verification records. It streamlines creating reliable skills by requiring observable verification before deployment.

How do I inventory optional components like scripts and assets during skill creation?

You inventory optional components like scripts, references, and assets during skill creation through automated detection. This validation process catalogs available components to support on-demand loading within your documentation.

Does skill authoring require toxicity safeguards validation before deployment?

Skill authoring requires toxicity safeguards validation before deployment to ensure baseline verification. The governance process validates these safeguards alongside YAML frontmatter requirements to maintain reliable, test-backed documentation.

What's the best way to document a skill verification baseline?

The best way to document a skill verification baseline is to specify the RED-GREEN-REFACTOR process within your SKILL.md. Include a clear name, description, and basic validation baseline to verify the skill before deployment.

Can I use test-driven skill authoring for governance and audit records?

Test-driven skill authoring supports governance and audit records by enforcing baseline failures and capturing verification records. This repeatable approach ensures under-specified skills become validated, observable, and difficult to audit.