Skip to content
Back to skills

Writing Skills

ASecurity

Use when creating new skills, editing existing skills, or verifying skills work before deployment.

  • 1,760 stars
  • 0 votes
  • 0 copies
  • 4 views
  • Added May 30, 2026
ai-agentsdocumentation

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned May 30, 2026

npx -y skills add a5c-ai/babysitter --skill writing-skills --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Writing Skills?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Writing Skills
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/a5c-ai-writing-skills/badge)](https://www.skillsdirectory.com/skills/a5c-ai-writing-skills)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: writing-skills
description: Use when creating new skills, editing existing skills, or verifying skills work before deployment.
---

# Writing Skills

## Overview

Writing skills IS Test-Driven Development applied to process documentation. Write pressure tests, watch agents fail, write the skill, watch them pass, close loopholes.

**Core principle:** If you did not watch an agent fail without the skill, you do not know if the skill teaches the right thing.

## TDD for Skills

| TDD Concept | Skill Creation |
|-------------|----------------|
| Test case | Pressure scenario with subagent |
| Production code | Skill document (SKILL.md) |
| RED | Agent violates rule without skill |
| GREEN | Agent complies with skill present |
| REFACTOR | Close loopholes |

## Skill Structure

- YAML frontmatter: `name` and `description` only
- Description: "Use when..." (triggering conditions only, never summarize workflow)
- Flat namespace, separate files only for heavy reference or reusable tools

## Tool Use

Meta-skill for creating new skills within the methodology.

Files in this skill

  • README.md207 B
  • SKILL.md1.1 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.