skills.rest
fernandoxavier02
fernandoxavier02COMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Create, edit, and validate Skills with YAML frontmatter and RED-GREEN-REFACTOR workflow.

Updated Aug 23, 2026
Search Tags:#workflow#tdd#documentation#validation#skill-writing#skill-authoring
One-click install
npx skills add https://github.com/fernandoxavier02/Superpower-Gemini --skill writing-skills-fernandoxavier02
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/fernandoxavier02/Superpower-Gemini/tree/main/skills/writing-skills
Command: npx skills add https://github.com/fernandoxavier02/Superpower-Gemini --skill writing-skills-fernandoxavier02

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing and validating skills is error-prone and requires disciplined testing. This section outlines the challenges of creating robust Skills.

Core Features & Use Cases

  • Workflow-guided Skill authoring from RED-GREEN-REFACTOR.
  • Progressive disclosure, references management, and reliance on SKILL.md frontmatter.
  • Use cases for testing, deployment, and maintenance of skills.

Quick Start

Create a Skill by defining a SKILL.md with frontmatter including name and description, then add optional scripts/references/assets as needed and write the body.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I start authoring a new skill with the correct SKILL.md frontmatter?▼

To start authoring a skill, create a SKILL.md file containing required YAML frontmatter fields for name and description, then optionally add scripts, references, or assets directories as needed.

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

The RED-GREEN-REFACTOR workflow for skill validation is a disciplined testing approach that ensures robust authoring by codifying test creation, implementation, and iterative refinement before deployment checks.

What optional directories can I include when creating a skill?▼

When creating a skill, you can include optional directories such as scripts/, references/, and assets/ alongside your required SKILL.md file to manage supporting components.

How do I validate an existing skill for compliance?▼

You validate an existing skill for compliance by running deployment checks and applying the codified RED-GREEN-REFACTOR testing workflow specified in the skill-writing guidelines.

Do I need any external dependencies to write and validate skills?▼

No external dependencies are required to write and validate skills, as the process relies entirely on managing SKILL.md frontmatter and internal directory structures.

Related Skills

Explore More Content & Communication Skills→
jonhill90jonhill90
8

validate-skill

Validate SKILL.md files' frontmatter and structure against the Agent Skills specification.

Community
Intermediate
seanGSISGseanGSISG
3

testing-skills-with-subagents

Test skills with subagents to verify resistance to rationalization under pressure.

Community
Basic
auldsyababuaauldsyababua
6

markdown-validation

Validate Markdown files for syntax, links, and formatting standards.

Community
Advanced
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate