Featured

writing-skills

Name: writing-skills
Rating: 5 (1097 reviews)
Author: udecode

Use when creating or editing rules/skills in .claude/rules/, whether context-specific skills (alwaysApply: false) or always-merged rules (alwaysApply: true) - applies TDD by identifying failure patterns (RED), writing rule/skill (GREEN), then closing loopholes (REFACTOR). Supports globs for file patterns. NEVER use "skill-creator" skill.

TL;DR

Apply TDD to skill creation: identify failures, write skills, verify, refine.

What Is It

Reusable techniques, patterns, or tools for problem-solving
Reference guides for proven methods and tools
Maintained in .claude/rules/ as MDC files
Generated into .claude/skills/ or merged into AGENTS.md

Key Features

Follows RED-GREEN-REFACTOR TDD cycle
Uses globs for file pattern matching
Requires alwaysApply: false or omitted for skill generation
Must run npx skiller@latest apply after creation
Skills are context-loaded or always-merged based on alwaysApply
Description must start with 'Use when...' and include symptoms and triggers

How to Use

1.Identify failure patterns (RED)
2.Write skill (documentation) addressing those patterns (GREEN)
3.Run npx skiller@latest apply to generate or merge skill
4.Verify effectiveness through application scenarios
5.Refactor to close loopholes (REFACTOR)
6.Never use 'skill-creator' skill

Guardrails & Gotchas

Never use 'skill-creator' skill
AlwaysApply: true only for always-merged rules (in AGENTS.md)
Description must be in third person, under 1024 chars, start with 'Use when'
Description must include symptoms, contexts, and triggers
Single-file skills only if under 50 lines and no heavy reference
Multi-file skills only if >1 file needed or heavy reference

GitHub Stats

Author

@udecode

Repository

udecode/dotai

Stars

1097

Explore More Skills

move-code-quality

@davila7

Analyzes Move language packages against the official Move Book Code Quality Checklist. Use this skill when reviewing Move code, checking Move 2024 Edition compliance, or analyzing Move packages for best practices. Activates automatically when working with .move files or Move.toml manifests.

12.4k

1.1k

1w ago

writing-skills

Explore More Skills

move-code-quality

e2e-testing-patterns

testing-anti-patterns