---
slug: "custom-claude"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/dawiddutoit/custom-claude@main/README.md"
repo: "https://github.com/dawiddutoit/custom-claude"
source_file: "README.md"
branch: "main"
---
# Claude Code Skills Collection

A comprehensive collection of 205+ production-ready skills for Claude Code, organized by domain and use case.

## 📦 What's Inside

- **205+ Skills** - Reusable workflows for architecture, testing, quality gates, Home Assistant, web development, cloud infrastructure, data engineering, document creation, and more
- **Agents** - Specialized autonomous agents for complex tasks
- **Plugins** - Extended functionality via Claude Code plugins
- **Commands** - Custom command-line tools

## 🚀 Quick Start

### Installation

Copy skills to your Claude config directory:

```bash
# Clone the repository
git clone https://github.com/dawiddutoit/custom-claude.git
cd custom-claude

# Install all skills
cp -r skills/* ~/.claude/skills/

# Install agents (optional)
cp -r agents/* ~/.claude/agents/
```

### Usage

Skills are invoked automatically by Claude Code when relevant, or you can explicitly trigger them:

```bash
# Run a specific skill
/skill quality-run-quality-gates

# List available skills
/skills
```

## 📚 Skills Catalog

### Architecture & Design (5 skills)
- `architecture-single-responsibility-principle` - SRP validation using multi-dimensional detection
- `architecture-validate-architecture` - Clean Architecture, Hexagonal, Layered, MVC validation
- `architecture-validate-layer-boundaries` - Domain layer boundary enforcement
- `architecture-validate-srp` - AST-based SRP violation detection
- `create-adr-spike` - Architecture Decision Records and research spikes

### Quality Gates & Code Review (13 skills)
- `quality-capture-baseline` - Capture quality metrics baseline
- `quality-code-review` - Automated code review with best practices
- `quality-detect-orphaned-code` - Find unused code and dead imports
- `quality-detect-refactor-markers` - Identify TODO, FIXME, HACK markers
- `quality-detect-regressions` - Compare against baseline to detect regressions
- `quality-reflective-questions` - Code quality self-assessment
- `quality-run-linting-formatting` - Run linters and formatters
- `quality-run-quality-gates` - Comprehensive quality gate execution
- `quality-run-type-checking` - Type checking with mypy/pyright
- `quality-verify-implementation-complete` - Verify feature completeness
- `quality-verify-integration` - CCV (Creation+Connection+Verification) validation
- `editing-claude` - Validate and optimize CLAUDE.md files
- `artifacts-creating-and-managing` - Manage project artifacts (ADRs, spikes, analysis)

### Testing (11 skills)
- `test-debug-failures` - Systematic test failure debugging
- `test-first-thinking` - Test-first development workflow
- `test-implement-constructor-validation` - Constructor validation tests
- `test-implement-factory-fixtures` - Factory pattern fixtures
- `test-organize-layers` - Organize tests by architectural layer
- `test-property-based` - Property-based testing with Hypothesis
- `test-setup-async` - Async test setup and patterns
- `setup-pytest-fixtures` - pytest fixture configuration
- `textual-snapshot-testing` - Snapshot testing for Textual TUIs
- `textual-test-fixtures` - Textual test fixtures
- `textual-test-patterns` - Textual testing patterns

### Implementation Patterns (6 skills)
- `implement-cqrs-handler` - CQRS command/query handlers
- `implement-dependency-injection` - dependency-injector patterns
- `implement-feature-complete` - 10-stage feature implementation lifecycle
- `implement-repository-pattern` - Repository pattern (Protocol + Implementation)
- `implement-retry-logic` - Retry with exponential backoff
- `implement-value-object` - Immutable domain value objects

### Python Best Practices (3 skills)
- `python-best-practices-async-context-manager` - Async context manager patterns
- `python-best-practices-fail-fast-imports` - Fail-fast import validation
- `python-best-practices-type-safety` - Type safety best practices

### Observability (3 skills)
- `observability-analyze-logs` - Log analysis and debugging
- `observability-analyze-session-logs` - Session-specific log analysis
- `observability-instrument-with-otel` - OpenTelemetry instrumentation

### Home Assistant (14 skills)
- `ha-button-cards` - Button card configuration with actions
- `ha-conditional-cards` - Conditional card visibility
- `ha-custom-cards` - HACS custom cards (ApexCharts, gauges, bubbles)
- `ha-dashboard-cards` - Dashboard card creation with static titles
- `ha-dashboard-create` - Programmatic dashboard creation via WebSocket
- `ha-dashboard-layouts` - Layout patterns (grid, stack, panel)
- `ha-error-checking` - Dashboard debugging and validation
- `ha-graphs-visualization` - History graphs and time-series charts
- `ha-mqtt-autodiscovery` - MQTT auto-discovery for IoT devices
- `ha-mushroom-cards` - Minimalist Mushroom card ecosystem
- `ha-rest-api` - REST API integration
- `ha-sunsynk-integration` - Sunsynk/Deye solar inverter integration
- `ha-validate-dashboards` - 3-tier dashboard validation

### Browser Automation (12 skills)
- `browser-layout-editor` - 2D layout editors with FastAPI + SVG
- `chrome-auth-recorder` - Record authenticated workflows as GIFs
- `chrome-browser-automation` - Chrome automation via MCP
- `chrome-form-filler` - Safe form filling with verification
- `chrome-gif-recorder` - Record workflows as annotated GIFs
- `playwright-console-monitor` - Monitor browser console logs
- `playwright-e2e-testing` - End-to-end testing patterns
- `playwright-form-validation` - Form validation testing
- `playwright-network-analyzer` - Network request analysis
- `playwright-responsive-screenshots` - Responsive screenshot capture
- `playwright-tab-comparison` - Multi-tab comparison testing
- `playwright-web-scraper` - Web scraping patterns
- `slack-gif-creator` - Create animated GIFs for Slack communications
- `webapp-testing` - Web application testing with Playwright

### Svelte/SvelteKit (13 skills)
- `svelte-add-accessibility` - Accessibility best practices
- `svelte-add-component` - Component creation workflow
- `svelte-components` - Component patterns library
- `svelte-create-spa` - SPA creation from scratch
- `svelte-deployment` - Deployment strategies
- `svelte-extract-component` - Extract reusable components
- `svelte-migrate-html-to-spa` - Migrate HTML to Svelte SPA
- `svelte-runes` - Svelte 5 runes patterns
- `svelte-setup-state-store` - State management setup
- `svelte5-showcase-components` - Svelte 5 component showcase
- `sveltekit-data-flow` - Data loading and forms
- `sveltekit-remote-functions` - Remote function calling
- `sveltekit-structure` - Project structure patterns

### OpenSCAD & CAD (4 skills)
- `openscad-cutlist-woodworkers` - Woodworking cut list generation
- `openscad-labeling` - Part labeling and annotations
- `openscad-workshop-tools` - Workshop tool design patterns
- `scad-load` - OpenSCAD project loading

### Textual TUI Framework (10 skills)
- `textual-app-lifecycle` - App lifecycle management
- `textual-data-display` - Data tables and displays
- `textual-event-messages` - Event and message handling
- `textual-layout-styling` - Layout and CSS styling
- `textual-reactive-programming` - Reactive programming patterns
- `textual-testing` - Testing strategies
- `textual-widget-development` - Custom widget development
- `temet-run-tui-patterns` - Temet-specific TUI patterns

### Utilities & Workflow (7 skills)
- `data-migration-versioning` - Data format migration and versioning
- `util-manage-todo` - Todo list management
- `util-multi-file-refactor` - Multi-file refactoring
- `util-research-library` - Library research and evaluation
- `util-resolve-serviceresult-errors` - ServiceResult error resolution
- `web-artifacts-builder` - Build web artifacts with shadcn components
- `write-atomic-tasks` - Atomic task decomposition

### Agent & SDK (4 skills)
- `agent-sdk-python` - Python Claude Agent SDK patterns and examples
- `manage-agents` - Agent lifecycle management
- `mcp-builder` - Create high-quality MCP (Model Context Protocol) servers
- `skill-creator` - Create and manage skills

### Domain-Specific (3 skills)
- `jira-builders` - JIRA integration builders
- `minimal-abstractions` - Minimal abstraction patterns
- `infra-manage-ssh-services` - SSH service management

### Document & Content Creation (7 skills)
- `algorithmic-art` - Generate algorithmic art and visualizations
- `doc-coauthoring` - Collaborative document authoring workflows
- `docx` - Create and edit Word documents (.docx) with formatting and styles
- `internal-comms` - Internal communications and company newsletters
- `pdf` - Comprehensive PDF manipulation (extract, create, merge, split, forms)
- `pptx` - Create and edit PowerPoint presentations (.pptx)
- `xlsx` - Spreadsheet creation, editing, formulas, and data analysis

### Design & Branding (4 skills)
- `brand-guidelines` - Brand identity and guidelines development
- `canvas-design` - Canvas-based design and graphics
- `frontend-design` - Frontend design patterns and components
- `theme-factory` - Design system and theme generation

### JIRA & Atlassian (5 skills)
- `build-jira-document-format` - Advanced ADF (Atlassian Document Format) document building
- `design-jira-state-analyzer` - Analyze and optimize JIRA workflow states
- `export-and-analyze-jira-data` - Export JIRA data for analysis and reporting
- `jira-api` - JIRA REST API integration patterns
- `work-with-adf` - Work with Atlassian Document Format

### Data Engineering (17 skills)
- `clickhouse-kafka-validation` - ClickHouse + Kafka validation patterns
- `clickhouse-materialized-views` - Real-time aggregation with materialized views
- `clickhouse-operations` - ClickHouse production operations and monitoring
- `clickhouse-query-optimization` - Query optimization for ClickHouse
- `kafka-consumer-implementation` - Kafka consumer patterns
- `kafka-integration-testing` - Integration testing for Kafka
- `kafka-producer-implementation` - Kafka producer patterns
- `kafka-schema-management` - Schema management for Kafka
- `otel-logging-patterns` - OpenTelemetry logging patterns

### Python Testing & Tools (16 skills)
- `pytest-adapter-integration-testing` - Integration testing for adapters
- `pytest-application-layer-testing` - Application layer testing
- `pytest-async-testing` - Async testing patterns
- `pytest-configuration` - pytest configuration patterns
- `pytest-coverage-measurement` - Code coverage measurement
- `pytest-domain-model-testing` - Domain model testing
- `pytest-mocking-strategy` - Mocking strategies for pytest
- `pytest-test-data-factories` - Test data factory patterns
- `pytest-type-safety` - Type safety in tests
- `uv-ci-cd-integration` - UV package manager CI/CD integration
- `uv-dependency-management` - UV dependency management
- `uv-project-migration` - Migrate to UV package manager
- `uv-project-setup` - Set up new project with UV
- `uv-python-version-management` - Python version management with UV
- `uv-tool-management` - Tool management with UV
- `uv-troubleshooting` - UV troubleshooting guide

### Infrastructure & Cloud (38 skills)
- `caddy-certificate-maintenance` - SSL certificate operations with Caddy
- `caddy-https-troubleshoot` - Troubleshoot HTTPS/SSL issues with Caddy
- `caddy-subdomain-add` - Add subdomains to Caddy configuration
- `cloudflare-access-add-user` - Add users to Cloudflare Access
- `cloudflare-access-setup` - Configure Cloudflare Access with OAuth
- `cloudflare-access-troubleshoot` - Troubleshoot Cloudflare Access issues
- `cloudflare-dns-operations` - Cloudflare DNS management
- `cloudflare-service-token-setup` - Cloudflare Access service tokens
- `cloudflare-tunnel-setup` - Set up Cloudflare Tunnel
- `cloudflare-tunnel-troubleshoot` - Troubleshoot Cloudflare Tunnel
- `github-webhook-setup` - GitHub webhook configuration
- `ha-operations` - Home Assistant operations and maintenance
- `infrastructure-backup-restore` - Infrastructure backup and restore
- `infrastructure-health-check` - Infrastructure health monitoring
- `infrastructure-monitoring-setup` - Set up infrastructure monitoring
- `pihole-dns-setup` - Pi-hole DNS setup
- `pihole-dns-troubleshoot` - Troubleshoot Pi-hole DNS issues
- `pihole-dns-troubleshoot-ipv6` - IPv6 troubleshooting for Pi-hole

### GCP & Cloud Platform (7 skills)
- `gcp-gke-cluster-setup` - GKE cluster setup and configuration
- `gcp-gke-cost-optimization` - GKE cost optimization strategies
- `gcp-gke-deployment-strategies` - GKE deployment patterns
- `gcp-gke-monitoring-observability` - GKE monitoring and observability
- `gcp-gke-troubleshooting` - GKE troubleshooting guide
- `gcp-gke-workload-identity` - GKE Workload Identity setup
- `gcp-pubsub` - Google Cloud Pub/Sub patterns

### Gradle & Java Build Tools (7 skills)
- `gradle-ci-cd-integration` - Gradle CI/CD integration
- `gradle-dependency-management` - Gradle dependency management
- `gradle-docker-jib` - Docker image building with Jib
- `gradle-performance-optimization` - Gradle build optimization
- `gradle-spring-boot-integration` - Spring Boot with Gradle
- `gradle-testing-setup` - Gradle test configuration
- `gradle-troubleshooting` - Gradle troubleshooting

### Terraform & IaC (6 skills)
- `terraform-basics` - Terraform fundamentals
- `terraform-gcp-integration` - Terraform with GCP
- `terraform-module-design` - Terraform module patterns
- `terraform-secrets-management` - Secrets management in Terraform
- `terraform-state-management` - Terraform state management
- `terraform-troubleshooting` - Terraform troubleshooting

### Java Development (6 skills)
- `java-best-practices-code-review` - Java code review best practices
- `java-best-practices-debug-analyzer` - Java debugging and analysis
- `java-best-practices-refactor-legacy` - Legacy Java code refactoring
- `java-best-practices-security-audit` - Java security auditing
- `java-spring-service` - Spring service development
- `java-test-generator` - Java test generation

### Lotus Notes Migration (5 skills)
- `lotus-analyze-nsf-structure` - Analyze Lotus Notes NSF structure
- `lotus-analyze-reference-dependencies` - Analyze Notes database dependencies
- `lotus-convert-rich-text-fields` - Convert rich text fields from Notes
- `lotus-migration` - Lotus Notes to modern platform migration
- `lotus-replace-odbc-direct-writes` - Replace ODBC direct writes

### Python Metrics & Observability (7 skills)
- `python-micrometer-business-metrics` - Business metrics with Micrometer
- `python-micrometer-cardinality-control` - Metrics cardinality management
- `python-micrometer-core` - Micrometer core patterns for Python
- `python-micrometer-gcp-cloud-monitoring` - GCP Cloud Monitoring integration
- `python-micrometer-metrics-setup` - Set up Micrometer metrics
- `python-micrometer-sli-slo-monitoring` - SLI/SLO monitoring
- `python-test-micrometer-testing-metrics` - Test metrics instrumentation

### CAD & OpenSCAD (1 additional skill)
- `openscad-collision-detection` - Collision detection for OpenSCAD models

## 🗂️ Repository Structure

```
.
├── skills/              # 205+ skill definitions
│   ├── architecture-*/  # Architecture & design skills
│   ├── quality-*/       # Quality gates & code review
│   ├── test-*/          # Testing skills
│   ├── implement-*/     # Implementation patterns
│   ├── ha-*/            # Home Assistant skills
│   ├── svelte-*/        # Svelte/SvelteKit skills
│   ├── clickhouse-*/    # ClickHouse data engineering
│   ├── kafka-*/         # Kafka streaming
│   ├── gcp-*/           # Google Cloud Platform
│   ├── cloudflare-*/    # Cloudflare infrastructure
│   ├── gradle-*/        # Gradle build tools
│   ├── terraform-*/     # Infrastructure as Code
│   ├── java-*/          # Java development
│   ├── lotus-*/         # Lotus Notes migration
│   ├── docx, xlsx, pptx, pdf  # Document creation skills
│   ├── brand-*, canvas-*, theme-*  # Design & branding
│   └── ...
├── agents/              # Custom agent definitions
├── plugins/             # Claude Code plugins
└── commands/            # Custom CLI commands
```

## 📖 Skill Structure

Each skill follows a standard structure:

```
skill-name/
├── SKILL.md            # Skill definition and documentation
├── examples/           # Usage examples (optional)
└── tests/              # Validation tests (optional)
```

## 🤝 Contributing

Contributions welcome! To add a new skill:

1. Create a new directory in `skills/`
2. Add a `SKILL.md` file following the skill template
3. Test the skill thoroughly
4. Submit a PR with a clear description

## 📜 License

MIT

## 🔗 Related Resources

- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
- [Claude Agent SDK](https://github.com/anthropics/claude-code-agent-sdk)
- [MCP Servers](https://modelcontextprotocol.io/)

## ✨ Highlights

### CCV Principle
Many skills enforce the **Creation + Connection + Verification** principle to ensure code isn't just written but actually integrated and working in production.

### Quality Gates
Comprehensive quality gate skills ensure code meets standards before merging:
- Type checking
- Linting and formatting
- Test coverage
- Regression detection
- Architecture validation

### Multi-Domain Support
Skills span multiple domains:
- **Backend:** Python, Java, CQRS, repositories, microservices
- **Frontend:** Svelte, SvelteKit, web components
- **Data Engineering:** ClickHouse, Kafka, streaming, analytics
- **Cloud & Infrastructure:** GCP, Cloudflare, Caddy, Pi-hole, Terraform
- **Testing:** pytest, Playwright, integration testing, test factories
- **Build Tools:** Gradle, UV package manager
- **Home Automation:** Home Assistant dashboards and integrations
- **CAD/3D:** OpenSCAD modeling and design
- **TUI:** Textual framework applications
- **Browser Automation:** Chrome, Playwright workflows
- **Observability:** OpenTelemetry, Micrometer metrics, logging
- **Migration:** Lotus Notes to modern platforms
- **JIRA & Atlassian:** Advanced ADF, workflows, automation
- **Document Creation:** Word, Excel, PowerPoint, PDF manipulation
- **Design & Branding:** Brand guidelines, themes, canvas design

---

**Last Updated:** 2026-01-22
**Total Skills:** 205+
**Maintained by:** [@dawiddutoit](https://github.com/dawiddutoit)
