This repository contains custom skills for Claude Code, designed to enhance development workflows with specialized expertise.
This is a personal skills marketplace that provides production-ready skills for various development tasks. All skills are designed to work seamlessly with Claude Code and can be installed automatically.
If this repository is hosted on GitHub (e.g., github.com/rknall/Skills), add it to Claude Code:
/plugin marketplace add rknall/SkillsFor other git hosting:
/plugin marketplace add <git-repository-url>Once the marketplace is added, you can browse and install skills:
/plugin install python-architecture-reviewOr install all skills from this marketplace at once through the plugin menu.
Version: 1.0.0 Category: Development Description: Comprehensive design architecture review for Python backend applications
A production-ready skill that provides expert-level architecture reviews covering:
- System architecture and design patterns
- Database design and optimization
- API design (REST/GraphQL/gRPC)
- Security architecture
- Scalability and performance
- Observability and monitoring
- Deployment strategies
- Code organization
- Resilience patterns
Key Features:
- Comprehensive review framework across 10+ dimensions
- Python-specific recommendations and best practices
- 12+ reference implementations of common patterns
- Technology stack recommendations for 2025
- Detailed architecture checklist
- Structured review outputs with prioritized recommendations
When to Use:
- Reviewing backend architecture designs
- Technology stack selection
- Scalability planning
- Security assessments
- Performance optimization planning
Version: 1.0.0 Category: Development Description: Comprehensive UI/UX design review with extensive accessibility analysis
A production-ready skill that provides expert-level design reviews covering:
- Accessibility: Complete WCAG 2.1/2.2 compliance checking (Level A, AA, AAA)
- Visual Design: Layout, typography, color theory, hierarchy, consistency
- User Experience: Usability heuristics, user flows, interaction patterns
- Responsive Design: Mobile-first approach, breakpoint strategy, adaptation
- Components: Button states, forms, modals, navigation, error handling
- Desktop Applications: Platform-specific patterns for Windows, macOS, Linux
Key Features:
- Comprehensive WCAG 2.1/2.2 compliance checklist
- Accessible component pattern library with code examples
- Testing tools and methodologies guide
- Platform-specific guidelines (Web, Windows, macOS, Linux)
- Color contrast analysis and recommendations
- Screen reader compatibility testing
- Keyboard navigation evaluation
- Prioritized recommendations (Critical → Low)
When to Use:
- Accessibility audits (WCAG compliance)
- Design system reviews
- Website/app usability evaluation
- Responsive design assessment
- Component library reviews
- Desktop application UI reviews
- Color palette and contrast verification
Version: 1.0.0 Category: Development Description: Comprehensive Docker and Docker Compose validation following best practices and security standards
A production-ready skill that provides expert-level Docker configuration validation:
- Dockerfile Validation: Syntax, multi-stage builds, security, best practices
- Docker Compose Validation: Modern syntax (no obsolete version field), service configuration
- Security Audit: Non-root users, exposed secrets, vulnerable base images
- Multi-Stage Build Verification: Proper stage implementation and optimization
- Automation: Generates validation scripts, CI/CD integrations, pre-commit hooks
- Comprehensive Reporting: Detailed issues with fixes, prioritized by severity
Key Features:
- Hadolint integration for deep Dockerfile analysis
- DCLint integration for Compose file linting
- Modern Compose syntax enforcement (v2.27.0+)
- Multi-stage build pattern validation
- Security vulnerability identification
- Automated validation script generation
- GitHub Actions and GitLab CI templates
- Complete validation checklists
When to Use:
- Validate Dockerfiles before deployment
- Audit Docker security and compliance
- Modernize Docker Compose files
- Review production readiness
- Create automated validation workflows
- Set up CI/CD pipeline validation
- Fix Docker configuration issues
Version: 1.0.0 Category: Design Description: Create professional HTML5/JavaScript web designs with Playwright verification
A production-ready skill that generates complete, accessible web designs from specifications:
- Design Generation: HTML5, CSS3, JavaScript for any web interface
- Playwright Integration: Automatic verification when MCP is available
- Accessibility Testing: WCAG 2.1 Level AA compliance checking
- Visual Verification: Screenshots at mobile, tablet, desktop breakpoints
- Functionality Testing: Forms, interactions, JavaScript validation
- Performance Analysis: Load time, resource optimization
- Framework Support: Vanilla, Tailwind CSS, React, Vue, Alpine.js
Key Features:
- Automatic Playwright MCP detection and graceful fallback
- Responsive, mobile-first designs
- Complete accessibility compliance (WCAG AA)
- Interactive component testing
- Performance metrics and optimization
- Design templates for common patterns
- Comprehensive verification reports
When to Use:
- Create landing pages or web applications
- Build responsive web interfaces
- Generate design mockups
- Refactor existing HTML/CSS/JS
- Create accessible WCAG-compliant designs
- Build component libraries
Version: 1.0.0 Category: Design Description: Generate professional SVG logos with multiple variations
A production-ready skill that creates scalable vector graphic logos:
- Multiple Concepts: 3-5 different design directions per request
- Layout Variations: Horizontal, vertical, square, icon-only, text-only
- Logo Types: Wordmarks, lettermarks, pictorial, abstract, combination, emblems
- Color Variations: Full color, monochrome dark/light, reversed
- Professional SVG: Clean, optimized, accessible code
- Usage Guidelines: Complete brand identity documentation
- Export Instructions: SVG to PNG conversion guidance
Key Features:
- Multiple logo concepts exploring different visual approaches
- Comprehensive layout options for all use cases
- Color psychology guidance and palette selection
- Scalable vector graphics work at any size
- Accessibility with title/desc elements
- Complete usage documentation
- File organization and naming conventions
When to Use:
- Create brand logos or visual identities
- Design icons or symbols
- Generate logo variations and concepts
- Produce scalable graphics for branding
- Create wordmarks or lettermarks
- Design for both digital and print applications
Version: 1.0.0 Category: Development Description: Validates GitLab stack projects before deployment with comprehensive checks
A production-ready skill that validates stack project configurations:
- Directory Structure: Required directories (./config, ./secrets, ./_temporary), permissions, .gitignore
- Environment Variables: .env and .env.example synchronization (critical requirement)
- Docker Configuration: Uses docker-validation skill for compose and Dockerfile checks
- Secrets Management: Docker secrets validation, permission checks, exposure detection
- Configuration Files: Syntax validation, proper organization, no embedded secrets
- File Ownership: Detects root-owned files, ensures proper permissions
- Scripts: docker-entrypoint.sh validation when necessary
- Temporary Files: ./_temporary directory usage and cleanup validation
Key Features:
- Critical .env/.env.example synchronization checking
- Integrates with docker-validation skill for Docker-specific validation
- Comprehensive security scanning for exposed secrets
- File ownership auditing (no root-owned files)
- Detailed, actionable validation reports
- Multiple output formats (text, JSON)
- Strict and permissive validation modes
- Custom validation rules support
- Works with companion skills (stack-creator, secrets-manager)
When to Use:
- Validate stack before deployment
- Pre-deployment health checks
- Audit stack configuration and security
- Verify .env and .env.example are in sync
- Check secrets management compliance
- Ensure Docker best practices
- CI/CD pipeline validation gates
- Identify configuration issues early
Version: 1.0.0 Category: Development Description: Secure Docker secrets management - ensures secrets never in .env or docker-compose.yml
A production-ready skill that manages Docker secrets securely:
- Secret Migration: Moves secrets from .env and docker-compose.yml to Docker secrets
- Secret Creation: Generates secure random secrets with proper permissions
- Validation: Detects secrets in wrong locations (critical security issue)
- Auditing: Find leaks, unused secrets, permission issues
- Git Protection: Ensures secrets never committed to version control
- docker-entrypoint.sh: Generates entrypoint scripts when containers lack native support
Key Features:
- Critical security focus: NO secrets in .env or docker-compose.yml environment
- Automatic migration from insecure locations
- Secure random secret generation (alphanumeric, hex, base64, UUID)
- Comprehensive leak detection across .env, compose, config files, git history
- File permission management (700/600)
- Integration with stack-validator for security checks
- Works with stack-creator for proper initialization
When to Use:
- Fix "secrets in .env" security issues
- Migrate environment variables to Docker secrets
- Create new secure secrets
- Validate secret configuration
- Audit secret usage and detect leaks
- Generate docker-entrypoint.sh for legacy containers
- Rotate existing secrets
- Ensure secrets not in git
Version: 1.0.0 Category: Development Description: Service configuration generator using .env as primary config source
A production-ready skill that generates service configurations:
- Service Templates: Nginx (3 variants), PostgreSQL (3 variants), Redis (3 variants)
- Meta Files: CLAUDE.md (with commit rules), .gitignore, .dockerignore
- Configuration Source: .env as single source of truth (not separate env files)
- Directory Structure: Service-specific directories (./config/service-name/)
- Strict Validation: No secrets in configs, .env/.env.example sync, path validation
- Docker Integration: Uses docker-validation skill for all Docker configs
Key Features:
- User-selectable template defaults (production, development, custom)
- Flat config structure inside each service directory
- Environment variable placeholders in all configs
- Critical .env and .env.example synchronization
- Secret detection with secrets-manager integration
- Path validation (all referenced paths must exist)
- Syntax validation per service type
- Meta files with proper git exclusions
When to Use:
- Generate service configurations (nginx, PostgreSQL, Redis)
- Set up project meta files (CLAUDE.md, .gitignore, .dockerignore)
- Create config templates for new services
- Ensure configs use .env variables correctly
- Validate existing configurations
- Sync .env and .env.example
Version: 1.0.0 Category: Development Description: Generate and validate Pangolin Newt blueprint configurations
A production-ready skill that creates Pangolin Newt blueprints:
- Blueprint Formats: YAML configuration files and Docker Compose labels
- Proxy Resources: HTTP (domain-based), TCP/UDP (port-based) resource configurations
- Client Resources: Olm client resources for SSH, RDP, and other protocols
- Authentication: SSO, basic auth, pincode, and password authentication
- Access Control: IP, CIDR, path, and country-based rules
- Validation: Comprehensive validation with helpful error messages
Key Features:
- Support for both YAML and Docker Labels format
- Protocol-specific validation (HTTP vs TCP/UDP requirements)
- Authentication configuration with SSO role/user management
- Multi-target load balancing support
- Path-based routing with prefix/exact/regex matching
- Custom header injection
- Targets-only resource configuration for simplified setups
- Detailed validation error explanations
- Best practices and security recommendations
When to Use:
- Create Pangolin blueprint configurations
- Expose web applications via domain names (HTTP)
- Expose databases or other services via ports (TCP/UDP)
- Configure Olm client resources
- Set up authentication and access control
- Validate existing blueprint configurations
- Convert between YAML and Docker Labels formats
- Troubleshoot blueprint validation errors
Version: 1.0.0 Category: Development Description: Create new GitLab stack projects with complete validation
A production-ready skill that creates GitLab stack projects from scratch:
- Directory Structure: Proper ./config, ./secrets, ./_temporary, ./scripts, ./docs setup
- Git Configuration: Initializes repository with main branch and ff-only merge strategy
- Validation Scripts: Creates validate-stack.sh, pre-commit hooks, setup-hooks.sh
- Docker Configuration: Generates docker-compose.yml validated by docker-validation skill
- Secrets Management: Integrates secrets-manager for secure secret handling
- Service Configs: Uses config-generator for nginx, PostgreSQL, Redis configurations
- Documentation: Generates README.md, CLAUDE.md, setup.md, services.md, ADRs
Key Features:
- Integrates stack-validator, secrets-manager, docker-validation, config-generator skills
- Never uses workarounds - always asks user for guidance when stuck
- Complete only when ALL validators pass with NO issues
- Git hooks for pre-commit validation (blocks commits if validation fails)
- Comprehensive templates for common stacks (web, full-stack)
- Architecture decision records in ./docs/decisions/
- ff-only merge strategy for clean git history
- main as default branch name
- All scripts executable and ready to use
When to Use:
- Create new GitLab stack project from scratch
- Initialize Docker stack with proper structure
- Set up project with validation from the start
- Bootstrap production-ready stack following best practices
- Need git repository with validation hooks
- Want complete documentation generated automatically
Completion Criteria: A stack is complete ONLY when:
- ✅ stack-validator reports NO issues
- ✅ secrets-manager is satisfied (NO open issues)
- ✅ docker-validation is satisfied (NO issues)
- ✅ All validation scripts execute successfully
- ✅ Git repository properly initialized and configured
- ✅ Documentation complete in ./docs
Skills/
├── .claude-plugin/
│ └── marketplace.json # Marketplace configuration
├── python-architecture-review/ # Python Backend Architecture Review Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ ├── architecture-checklist.md # Complete review checklist
│ ├── common-patterns.md # Reference implementations
│ └── technology-recommendations.md # Tech stack guide
├── ui-design-review/ # UI/UX Design Review Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ ├── wcag-checklist.md # WCAG 2.1/2.2 compliance checklist
│ ├── design-patterns-library.md # Accessible component patterns
│ └── testing-resources.md # Testing tools and methods
├── docker-validation/ # Docker Configuration Validator Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ ├── validation-checklist.md # Complete validation checklist
│ └── tool-installation.md # Tool setup guide
├── web-design-builder/ # Web Design Builder Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ └── design-templates.md # Ready-to-use templates
├── svg-logo-designer/ # SVG Logo Designer Skill
│ ├── SKILL.md # Main skill definition
│ └── README.md # Skill documentation
├── stack-validator/ # GitLab Stack Validator Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ ├── validation-patterns.md # Architecture patterns and examples
│ └── common-issues.md # Issue reference guide
├── secrets-manager/ # GitLab Stack Secrets Manager Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ ├── secrets-patterns.md # Security patterns and best practices
│ └── migration-guide.md # Step-by-step migration scenarios
├── config-generator/ # GitLab Stack Config Generator Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ ├── service-templates.md # Service templates (nginx, postgres, redis)
│ └── validation-rules.md # Validation rules reference
├── newt-blueprint-generator/ # Newt Blueprint Generator Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ └── validation-reference.md # Validation rules reference
├── stack-creator/ # GitLab Stack Creator Skill
│ ├── SKILL.md # Main skill definition
│ ├── README.md # Skill documentation
│ ├── git-hooks-guide.md # Git hooks and validation scripts
│ ├── templates-reference.md # docker-compose and config templates
│ └── workflow-examples.md # Example workflows
└── README.md # This file
- Create a new directory for your skill:
mkdir my-new-skill
cd my-new-skill- Create a
SKILL.mdfile with YAML frontmatter:
---
name: "My Skill Name"
description: "What this skill does and when to use it"
---
# My Skill Name
## Instructions
[Your skill instructions here...]- Add your skill to
.claude-plugin/marketplace.json:
{
"plugins": [
{
"name": "my-new-skill",
"source": "./my-new-skill",
"description": "Description of my skill",
"version": "1.0.0"
}
]
}- Test your skill locally by installing it:
/plugin install my-new-skill- Clear Description: Make sure your description explains both what the skill does AND when Claude should use it
- Comprehensive Instructions: Provide detailed, step-by-step guidance
- Examples: Include example usage and code snippets where relevant
- Reference Resources: Add supporting documents (checklists, patterns, etc.)
- Version Control: Update version numbers when making changes
A well-structured skill can include:
SKILL.md- Main skill definition (required)README.md- User-facing documentation- Supporting markdown files - Reference materials, checklists, patterns
- Scripts or templates - Reusable code or configuration
- Examples - Sample inputs/outputs
To ensure your team uses the same skills, add a .claude/config.json to your project repository:
{
"marketplaces": [
"rknall/Skills"
],
"plugins": [
"python-architecture-review"
]
}When team members trust your repository folder, Claude Code will automatically install these marketplaces and plugins.
Before publishing, test your skills locally:
- Copy the skill directory to
~/.claude/skills/ - Restart Claude Code or run
/reload - Trigger the skill by asking Claude to perform the relevant task
The .claude-plugin/marketplace.json file defines this marketplace:
{
"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
"name": "rknall-custom-skills",
"version": "1.0.0",
"description": "Custom Claude Code skills marketplace for advanced development workflows",
"owner": {
"name": "rknall"
},
"plugins": [...]
}This marketplace can be distributed via:
- GitHub repository (recommended)
- GitLab repository
- Any git hosting service
- Direct URL to git repository
Users install it with a single command:
/plugin marketplace add rknall/Skills- Added GitLab Stack Config Generator skill v1.0.0
- Service-specific configuration generation for GitLab stack projects
- .env as primary configuration source (single source of truth)
- Service templates: Nginx (3 variants), PostgreSQL (3 variants), Redis (3 variants)
- Meta files generation: CLAUDE.md (with commit message rules), .gitignore, .dockerignore
- User-selectable template defaults (production, development, custom)
- Strict .env and .env.example synchronization checking
- Secret detection with secrets-manager integration
- Path validation for all referenced files and directories
- Docker validation using docker-validation skill (always)
- Comprehensive service templates with complete examples
- Added GitLab Stack Secrets Manager skill v1.0.0
- Secure Docker secrets management for GitLab stack projects
- Critical focus: ensures secrets NEVER in .env or docker-compose.yml
- Automatic migration from insecure locations
- Secret creation with secure random generation (alphanumeric, hex, base64, UUID)
- Comprehensive validation and leak detection
- docker-entrypoint.sh generation for legacy containers
- File permission management (700/600)
- Git protection and history scanning
- Integration with stack-validator for security checks
- Complete migration guide with step-by-step scenarios
- Added GitLab Stack Validator skill v1.0.0
- Comprehensive stack project validation before deployment
- Critical .env and .env.example synchronization checking
- Directory structure, secrets management, and ownership validation
- Integrates with docker-validation skill for Docker-specific checks
- Multiple validation modes (standard, strict, permissive)
- JSON and text output formats for CI/CD integration
- Works with companion skills: stack-creator and secrets-manager
- Complete validation patterns and common issues reference guides
- Added Docker Configuration Validator skill v1.0.0
- Comprehensive Dockerfile and Docker Compose validation
- Modern Compose syntax enforcement (no obsolete version field)
- Multi-stage build verification
- Security audit capabilities
- Hadolint and DCLint integration
- Automated validation script generation
- CI/CD integration templates (GitHub Actions, GitLab CI)
- Complete validation checklists and tool installation guides
- Added Web Design Builder skill v1.0.0
- HTML5/JavaScript design generation
- Playwright MCP integration for automatic verification
- Accessibility, visual, and functionality testing
- Multiple framework support (Vanilla, Tailwind, React, Vue, Alpine.js)
- Design templates for common patterns
- Added SVG Logo Designer skill v1.0.0
- Professional logo generation with multiple concepts
- Layout variations (horizontal, vertical, square, icon, text)
- All major logo types supported
- Color psychology guidance
- Complete usage guidelines
- Added UI/UX Design Review skill v1.0.0
- Comprehensive WCAG 2.1/2.2 compliance framework
- Accessible component pattern library
- Visual design and UX evaluation
- Testing tools and resources guide
- Initial marketplace setup
- Python Backend Architecture Review skill v1.0.0
- Comprehensive review framework
- 12+ architectural patterns
- Technology recommendations for 2025
- Complete architecture checklist
To add or improve skills in this marketplace:
- Create or modify the skill in its directory
- Update the skill's README.md with documentation
- Update marketplace.json with any new skills
- Update version numbers appropriately
- Test locally before committing
Planned skills for future releases:
- Frontend Architecture Review (React/Vue/Angular)
- Infrastructure as Code Review (Terraform/CloudFormation)
- Kubernetes Configuration Validator (manifest validation, best practices)
- Security Audit Skill (penetration testing, threat modeling)
- Performance Optimization Skill (profiling, benchmarking)
- Database Schema Review Skill
- API Design Review Skill (REST, GraphQL, gRPC)
- Microservices Architecture Skill
- Code Quality Review Skill (refactoring, technical debt)
- Documentation Review Skill (technical writing, API docs)
For issues, questions, or suggestions:
- Open an issue in this repository
- Contact the maintainer directly
These skills are provided as-is for use with Claude Code. Individual skills may have their own licensing terms.
Marketplace Version: 0.6.2 Last Updated: 2025-10-20 Maintainer: rknall
