Skill Reference

Expert guidance for creating, writing, building, and refining Claude Code Skills. Use when working with SKILL.md files or authoring new skills.

Capabilities

• Skill architecture and best practices
• Router pattern for complex multi-step skills
• Progressive disclosure design principles
• SKILL.md structure guidance
• Asset management (workflows, references, templates, scripts)
• XML structure patterns

Workflows Included

• create-new-skill - Start from scratch
• add-reference - Add reference documentation
• add-template - Add code templates
• add-workflow - Add step-by-step procedures
• add-script - Add executable scripts
• audit-skill - Validate skill structure
• verify-skill - Test skill functionality

skill: create-agent-skills

Guide for creating effective skills with a 6-step process.

6-Step Process

1. Understand skill usage patterns with examples
2. Plan reusable skill contents
3. Initialize skill using template
4. Edit skill with clear instructions
5. Package skill into distributable zip
6. Iterate based on testing feedback

skill: skill-creator

Write Ruby and Rails code in DHH's distinctive 37signals style. Triggers on Ruby/Rails code generation or when mentioning DHH, 37signals, Basecamp, HEY.

Key Patterns

• REST Purity - 7 REST actions only
• Fat Models - Business logic, authorization, broadcasting in models
• Thin Controllers - 1-5 line actions
• Current Attributes - Request context
• Hotwire/Turbo - Model-level broadcasting

Ruby Syntax Preferences

• Symbol arrays %i[...]
• Modern hash syntax
• Ternaries for simple conditionals
• Bang methods for mutations

skill: dhh-ruby-style

Write Ruby gems following Andrew Kane's proven patterns and philosophy. Based on 100+ gems with 374M+ downloads.

Philosophy

• Simplicity over cleverness
• Zero or minimal dependencies
• Explicit code over metaprogramming
• Rails integration without Rails coupling

Key Patterns

• Class macro DSL for configuration
• ActiveSupport.on_load for Rails integration
• class << self with attr_accessor
• Railtie pattern for hooks
• Minitest (no RSpec)

Reference Files

• references/module-organization.md
• references/rails-integration.md
• references/database-adapters.md
• references/testing-patterns.md

skill: andrew-kane-gem-writer

Build type-safe, composable LLM applications with DSPy.rb. Use when implementing predictable AI features in Ruby.

Predictor Types

• Predict - Basic inference
• ChainOfThought - Reasoning with explanations
• ReAct - Tool-using agents with iteration
• CodeAct - Dynamic code generation

Supported Providers

• OpenAI (GPT-4, GPT-4o-mini)
• Anthropic Claude
• Google Gemini
• Ollama (free, local)
• OpenRouter

Requirements

skill: dspy-ruby

Create distinctive, production-grade frontend interfaces. Generates creative, polished code that avoids generic AI aesthetics.

Design Thinking

• Purpose - What is the interface for?
• Tone - What feeling should it evoke?
• Constraints - Technical and brand limitations
• Differentiation - How to stand out

Focus Areas

• Typography with distinctive font choices
• Color & theme coherence with CSS variables
• Motion and animation patterns
• Spatial composition with asymmetry
• Backgrounds (gradients, textures, patterns)

skill: frontend-design

Capture solved problems as categorized documentation with YAML frontmatter for fast lookup.

Auto-Triggers

Phrases: "that worked", "it's fixed", "working now", "problem solved"

7-Step Process

1. Detect confirmation phrase
2. Gather context (module, symptom, investigation, root cause)
3. Check existing docs for similar issues
4. Generate filename
5. Validate YAML frontmatter
6. Create documentation in category directory
7. Cross-reference related issues

Categories

• build-errors/
• test-failures/
• runtime-errors/
• performance-issues/
• database-issues/
• security-issues/

skill: codify-docs

Review and edit copy to ensure adherence to Every's style guide. Provides systematic line-by-line review.

Four-Phase Review

1. Initial Assessment - Context, type, audience, tone
2. Detailed Line Edit - Sentence structure, punctuation, capitalization
3. Mechanical Review - Spacing, formatting, consistency
4. Recommendations - Actionable improvement suggestions

Style Checks

• Grammar and punctuation
• Style guide compliance
• Capitalization rules
• Word choice optimization
• Formatting consistency

skill: every-style-editor

File-based todo tracking system in the todos/ directory. Integrates with code review and slash commands.

File Format

# Naming convention
{issue_id}-{status}-{priority}-{description}.md

# Examples
001-pending-p1-security-vulnerability.md
002-ready-p2-performance-optimization.md
003-complete-p3-code-cleanup.md

Status Values

• pending - Needs triage
• ready - Approved for work
• complete - Done

Priority Values

• p1 - Critical
• p2 - Important
• p3 - Nice-to-have

YAML Frontmatter

---
status: pending
priority: p1
issue_id: "001"
tags: [security, authentication]
dependencies: []
---

skill: file-todos

Manage Git worktrees for isolated parallel development. Handles creating, listing, switching, and cleaning up worktrees.

Commands

# Create new worktree
bash scripts/worktree-manager.sh create feature-login

# List worktrees
bash scripts/worktree-manager.sh list

# Switch to worktree
bash scripts/worktree-manager.sh switch feature-login

# Clean up completed worktrees
bash scripts/worktree-manager.sh cleanup

Integration

• Works with /workflows:review for isolated PR analysis
• Works with /workflows:work for parallel feature development

Requirements

• Git 2.8+ (for worktree support)
• Worktrees stored in .worktrees/ directory

skill: git-worktree