How do I ensure my skills are token-efficient?

Keep instructions concise, move heavy references to separate files, use cross-references instead of repeating logic, and aim for word counts under 200 for frequently loaded skills.

Where should I store my personal Claude Code skills?

Personal skills for Claude Code are typically stored in the ~/.claude/skills directory, while project-specific conventions should go in CLAUDE.md.

What is the TDD approach to writing skills?

It involves creating a pressure scenario to watch the AI fail (Red), writing the skill documentation (Green), and then refining the instructions to close loopholes (Refactor).

What is Claude Search Optimization (CSO)?

CSO is a set of practices designed to help Claude efficiently find and load the most relevant skills by using specific keyword coverage and trigger-based descriptions.

Why shouldn't skill descriptions summarize the workflow?

Summarizing the workflow in the description can cause Claude to skip the full skill content and follow the brief summary instead, often missing critical nuances or steps.

Writing Skills

Name: Writing Skills
Author: pur3v4d3r

bypur3v4d3r

•

学習とドキュメンテーション

Applies Test-Driven Development (TDD) principles to the creation and verification of AI-ready documentation and Claude Code skills.

Writing Skills transforms skill creation from a narrative exercise into a rigorous engineering process. By adapting the Red-Green-Refactor cycle to documentation, it ensures that every skill is built upon observed AI failure patterns and verified through pressure testing with subagents. This skill provides a standardized framework for Claude Search Optimization (CSO), focusing on token efficiency and precise triggering conditions to ensure Claude finds and follows the right guidance at the right time.

主な機能

01Red-Green-Refactor workflow for documentation

02Claude Search Optimization (CSO) for discovery

03Token-efficient authoring patterns

041 GitHub stars

05Pressure-test scenario generation with subagents

06Standardized SKILL.md structure and YAML frontmatter

ユースケース

01Verifying skill effectiveness through baseline failure analysis

02Developing new domain-specific skills for Claude Code

03Optimizing existing documentation for better AI compliance

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pur3v4d3r/pur3-pkb-codebase writing-skills

For use in Claude.ai and ChatGPT

Download Skill