skills.rest
lapaixkemsdortshlee-svg
lapaixkemsdortshlee-svgCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Create and validate SKILL.md files with structured documentation and testing guidance.

Updated Apr 3, 2026
Search Tags:#tdd#documentation#prompt design#skill authoring#skill validation#agent instructions
One-click install
npx skills add https://github.com/lapaixkemsdortshlee-svg/AyitiMarket --skill writing-skills-lapaixkemsdortshlee-svg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/lapaixkemsdortshlee-svg/AyitiMarket/tree/main/.claude/skills/writing-skills
Command: npx skills add https://github.com/lapaixkemsdortshlee-svg/AyitiMarket --skill writing-skills-lapaixkemsdortshlee-svg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps create, edit, and verify reusable skills so they are discoverable, concise, and ready for deployment without missing required structure or validation.

Core Features & Use Cases

  • Skill authoring guidance: Define clear SKILL.md frontmatter, naming, and discovery-focused descriptions.
  • Testing and verification: Use RED-GREEN-REFACTOR thinking to pressure-test skills before they are released.
  • Documentation structure: Organize overviews, quick references, examples, and supporting files for maintainable skill design.
  • Use case: A team building a new workflow skill can use this to write the instruction file, test it against failure scenarios, and refine loopholes before sharing it.

Quick Start

Use this skill to draft or revise a SKILL.md file and verify that its name, description, structure, and testing guidance are clear and deployment-ready.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write documentation for reusable agent instructions?▼

Writing reusable agent instructions requires structured SKILL.md files with clear frontmatter, discovery-focused descriptions, and concise overviews. This skill guides authoring and editing to ensure documentation is deployment-ready and maintainable.

How does TDD apply to skill validation before deployment?▼

TDD applies to skill validation through RED-GREEN-REFACTOR thinking, pressure-testing agent instructions against failure scenarios before release. This process identifies loopholes and refines documentation to ensure reliable deployment.

What is the best way to structure SKILL.md files for discoverability?▼

Structuring SKILL.md files for discoverability involves organizing clear frontmatter, naming conventions, overviews, quick references, and supporting references. This skill helps define concise structures with optional supporting scripts when needed.

Can I use this skill to pressure-test workflow documentation?▼

Yes, you can use this skill to pressure-test workflow documentation by applying RED-GREEN-REFACTOR thinking to verify agent instructions against failure scenarios. This ensures skills are refined and ready for deployment without missing required structure.

Do I need any dependencies to author and verify skill documentation?▼

No dependencies are required to author and verify skill documentation with this skill. It independently creates, edits, and validates reusable SKILL.md files, applying discovery-friendly metadata and concise structure for maintainable design.

Why does my skill documentation fail validation checks?▼

Skill documentation fails validation when it is missing required structure, lacks discovery-friendly metadata, or contains unclear naming and descriptions. This skill helps identify and refine loopholes using testing and verification scenarios.

Related Skills

Explore More Content & Communication Skills→
brobertsazbrobertsaz
406

remember-this

Capture conversation insights and save them as markdown documents to Claude OS knowledge bases.

Community
Advanced
rishikanthcrishikanthc

writing-skills

Create and verify SKILL.md documentation using RED-GREEN-REFACTOR pressure scenarios.

Community
Advanced
KuassKuass
1

testing-skills-with-subagents

Apply Test-Driven Development cycles to create and refine AI agent skills.

Community
Advanced
Lands-1203Lands-1203
40

f2s-doc-arch

Generate project architecture description drafts from documentation or code.

Community
Intermediate