What is the primary goal of the writing-skills skill?

Its goal is to provide a rigorous standard for authoring new skills, ensuring they are persuasive, concise, and structured in a way that AI agents follow without rationalizing failures.

What is an anti-rationalization table?

It is a specialized table included in discipline skills that maps common excuses (rationalizations) to reality, preventing the agent from skipping essential verification steps.

What are persuasion principles in AI skills?

They are linguistic techniques like using imperative language ('YOU MUST') and social proof ('Always') that have been shown to double compliance rates in LLM behavior.

Why are word counts enforced for Claude skills?

Smaller word counts (under 800 words max) ensure that the AI agent stays focused and doesn't lose critical instructions in a large context window, leading to higher accuracy.

Claude Skill Authoring Guide

Name: Claude Skill Authoring Guide
Author: josephneumann

byjosephneumann

•

학습 및 문서화

Provides a standardized framework for creating persuasive, high-performance instructions and SKILL.md files for Claude Code.

The writing-skills skill is a meta-utility designed to optimize how Claude Code skills are authored, ensuring they are concise, authoritative, and effective. By implementing specific word count targets, persuasion principles, and anti-rationalization tables, this skill helps developers build domain-specific instructions that maximize agent compliance and minimize 'AI slop'. It focuses on triggering conditions rather than workflow summaries to prevent agents from shortcutting intended procedures.

주요 기능

01Standardizes SKILL.md structure with a focus on triggering conditions

02Eliminates instruction redundancy through context-specific cross-referencing

032 GitHub stars

04Implements psychological persuasion techniques to increase agent compliance

05Provides anti-rationalization frameworks to prevent common agent failures

06Enforces strict word count targets for high-performance context management

사용 사례

01Refactoring existing, bloated instructions into a more authoritative format

02Converting successful manual sequences into reusable, production-grade skills

03Writing a new SKILL.md for a project-specific workflow

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add josephneumann/claude-corps writing-skills

For use in Claude.ai and ChatGPT

Download Skill