Why does this skill emphasize a 'Gotchas' section?

Gotchas are the most information-dense part of a skill, built from real agent failure points to prevent the AI from making common mistakes or rationalizing shortcuts under pressure.

What is the RED-GREEN-REFACTOR method for skill building?

It involves establishing a baseline failure without the skill (RED), writing a minimal skill to address that specific failure (GREEN), and refining the skill to close loopholes and optimize for token efficiency (REFACTOR).

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability or reference guide that enhances how Claude performs specific tasks by providing domain-specific guidance, best practices, and implementation patterns.

How do skills differ from project conventions?

Skills are reusable techniques, patterns, or tools applicable across multiple projects, whereas project-specific conventions belong in a project-level CLAUDE.md file.

Skill Crafting

Name: Skill Crafting
Author: renathoaz

byrenathoaz

•

Developer Tools

Facilitates the systematic creation and refinement of disciplined AI agent skills through evaluation-driven development.

Skill Crafting provides a rigorous framework for building composable agent capabilities by following a specialized RED-GREEN-REFACTOR cycle adapted for LLMs. It ensures that every new skill is grounded in observed agent failures, utilizing progressive disclosure to maintain context efficiency and 'bulletproof' discipline to prevent agents from rationalizing shortcuts. This skill is essential for developers who need to transform generic AI assistants into specialized, disciplined engineers that adhere to complex technical patterns and domain-specific best practices.

Key Features

012 GitHub stars

02Deterministic script integration for precise, judgment-free tool execution

03Standardized folder-based structure for progressive disclosure and context efficiency

04Evaluation-driven RED-GREEN-REFACTOR workflow for skill development

05Adversarial pressure testing to identify and counter agent rationalizations

06Guidance on writing high-signal 'Gotchas' sections based on real failure patterns

Use Cases

01Hardening agent behavior against common failure modes and logic shortcuts

02Encoding project-specific engineering standards into reusable agent skills

03Building a library of composable tools and patterns for specialized development tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add renathoaz/arsyn skill-crafting

For use in Claude.ai and ChatGPT