Skip to content
Back to search

rknall-custom-skills

MarketplaceWorks with Claude CodeGitHub

Custom Claude Code skills marketplace for architecture review, accessibility expertise, creative design generation, DevOps validation, infrastructure configuration, and GitLab stack management

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rknall-claude-skills/badge.svg)](/listings/rknall-claude-skills)

HTML

<a href="/listings/rknall-claude-skills"><img src="/api/listings/rknall-claude-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Add This Marketplace

If this repository is hosted on GitHub (e.g., `github.com/rknall/Skills`), add it to Claude Code:

/plugin marketplace add rknall/Skills

For other git hosting:

/plugin marketplace add <git-repository-url>

Install Individual Skills

Once the marketplace is added, you can browse and install skills:

/plugin install python-architecture-review

Or install all skills from this marketplace at once through the plugin menu.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 81 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "rknall-custom-skills",
  4. "version": "0.7.1",
  5. "description": "Custom Claude Code skills marketplace for architecture review, accessibility expertise, creative design generation, DevOps validation, infrastructure configuration, and GitLab stack management",
  6. "owner": {
  7. "name": "rknall"
  8. },
  9. "plugins": [
  10. {
  11. "name": "python-architecture-review",
  12. "source": "./python-architecture-review",
  13. "description": "Comprehensive design architecture review for Python backend applications, analyzing scalability, security, performance, and best practices",
  14. "version": "1.0.0",
  15. "category": "development"
  16. },
  17. {
  18. "name": "ui-design-review",
  19. "source": "./ui-design-review",
  20. "description": "Comprehensive UI/UX design review for websites and desktop applications with extensive WCAG 2.1/2.2 accessibility analysis, usability evaluation, and visual design assessment",
  21. "version": "1.0.0",
  22. "category": "development"
  23. },
  24. {
  25. "name": "docker-validation",
  26. "source": "./docker-validation",
  27. "description": "Comprehensive Docker and Docker Compose validation following best practices and security standards. Validates Dockerfiles, multi-stage builds, modern Compose syntax, and generates automation scripts",
  28. "version": "1.0.0",
  29. "category": "development"
  30. },
  31. {
  32. "name": "web-design-builder",
  33. "source": "./web-design-builder",
  34. "description": "Create professional HTML5/JavaScript web designs from specifications with automatic Playwright MCP verification for accessibility and functionality testing",
  35. "version": "1.0.0",
  36. "category": "design"
  37. },
  38. {
  39. "name": "svg-logo-designer",
  40. "source": "./svg-logo-designer",
  41. "description": "Generate professional SVG logos with multiple concepts, layouts, and variations. Creates scalable vector graphics with comprehensive usage guidelines",
  42. "version": "1.0.0",
  43. "category": "design"
  44. },
  45. {
  46. "name": "stack-validator",
  47. "source": "./stack-validator",
  48. "description": "Validates GitLab stack projects before deployment, ensuring proper architecture patterns, directory structure, secrets management, .env configuration, and Docker best practices. Detects issues and provides actionable guidance",
  49. "version": "1.0.0",
  50. "category": "development"
  51. },
  52. {
  53. "name": "secrets-manager",
  54. "source": "./secrets-manager",
  55. "description": "Manages Docker secrets for GitLab stack projects, ensuring secrets are never in .env or docker-compose.yml. Handles migration from environment variables, validation, auditing, and secure secret generation",
  56. "version": "1.0.0",
  57. "category": "development"
  58. },
  59. {
  60. "name": "config-generator",
  61. "source": "./config-generator",
  62. "description": "Generates service-specific configuration files for GitLab stack projects using .env as primary config source. Creates nginx, PostgreSQL, Redis configs, meta files (CLAUDE.md, .gitignore, .dockerignore), with strict validation for secrets and paths",
  63. "version": "1.0.0",
  64. "category": "development"
  65. },
  66. {
  67. "name": "newt-blueprint-generator",
  68. "source": "./newt-blueprint-generator",
  69. "description": "Generate and validate Pangolin Newt blueprint configurations in YAML or Docker Labels format. Creates proxy resources (HTTP/TCP/UDP), client resources, authentication settings, and access control rules",
  70. "version": "1.0.0",
  71. "category": "development"
  72. },
  73. {
  74. "name": "stack-creator",
  75. "source": "./stack-creator",
  76. "description": "Create new GitLab stack projects with proper directory structure, git configuration (main branch, ff-only), validation hooks, and comprehensive documentation. Integrates stack-validator, secrets-manager, docker-validation, and config-generator. Complete only when all validations pass",
  77. "version": "0.1.0",
  78. "category": "development"
  79. }
  80. ]
  81. }
README.md · README · 696 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # rknall Custom Claude Code Skills
  2. This repository contains custom skills for Claude Code, designed to enhance development workflows with specialized expertise.
  3. ## About This Marketplace
  4. 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.
  5. ## Installation
  6. ### Add This Marketplace
  7. If this repository is hosted on GitHub (e.g., `github.com/rknall/Skills`), add it to Claude Code:
  8. ```bash
  9. /plugin marketplace add rknall/Skills
  10. ```
  11. For other git hosting:
  12. ```bash
  13. /plugin marketplace add <git-repository-url>
  14. ```
  15. ### Install Individual Skills
  16. Once the marketplace is added, you can browse and install skills:
  17. ```bash
  18. /plugin install python-architecture-review
  19. ```
  20. Or install all skills from this marketplace at once through the plugin menu.
  21. ## Available Skills
  22. ### 1. Python Backend Architecture Review
  23. **Version:** 1.0.0
  24. **Category:** Development
  25. **Description:** Comprehensive design architecture review for Python backend applications
  26. A production-ready skill that provides expert-level architecture reviews covering:
  27. - System architecture and design patterns
  28. - Database design and optimization
  29. - API design (REST/GraphQL/gRPC)
  30. - Security architecture
  31. - Scalability and performance
  32. - Observability and monitoring
  33. - Deployment strategies
  34. - Code organization
  35. - Resilience patterns
  36. **Key Features:**
  37. - Comprehensive review framework across 10+ dimensions
  38. - Python-specific recommendations and best practices
  39. - 12+ reference implementations of common patterns
  40. - Technology stack recommendations for 2025
  41. - Detailed architecture checklist
  42. - Structured review outputs with prioritized recommendations
  43. **When to Use:**
  44. - Reviewing backend architecture designs
  45. - Technology stack selection
  46. - Scalability planning
  47. - Security assessments
  48. - Performance optimization planning
  49. [View Full Documentation](./python-architecture-review/README.md)
  50. ### 2. UI/UX Design Review
  51. **Version:** 1.0.0
  52. **Category:** Development
  53. **Description:** Comprehensive UI/UX design review with extensive accessibility analysis
  54. A production-ready skill that provides expert-level design reviews covering:
  55. - **Accessibility**: Complete WCAG 2.1/2.2 compliance checking (Level A, AA, AAA)
  56. - **Visual Design**: Layout, typography, color theory, hierarchy, consistency
  57. - **User Experience**: Usability heuristics, user flows, interaction patterns
  58. - **Responsive Design**: Mobile-first approach, breakpoint strategy, adaptation
  59. - **Components**: Button states, forms, modals, navigation, error handling
  60. - **Desktop Applications**: Platform-specific patterns for Windows, macOS, Linux
  61. **Key Features:**
  62. - Comprehensive WCAG 2.1/2.2 compliance checklist
  63. - Accessible component pattern library with code examples
  64. - Testing tools and methodologies guide
  65. - Platform-specific guidelines (Web, Windows, macOS, Linux)
  66. - Color contrast analysis and recommendations
  67. - Screen reader compatibility testing
  68. - Keyboard navigation evaluation
  69. - Prioritized recommendations (Critical → Low)
  70. **When to Use:**
  71. - Accessibility audits (WCAG compliance)
  72. - Design system reviews
  73. - Website/app usability evaluation
  74. - Responsive design assessment
  75. - Component library reviews
  76. - Desktop application UI reviews
  77. - Color palette and contrast verification
  78. [View Full Documentation](./ui-design-review/README.md)
  79. ### 3. Docker Configuration Validator
  80. **Version:** 1.0.0
  81. **Category:** Development
  82. **Description:** Comprehensive Docker and Docker Compose validation following best practices and security standards
  83. A production-ready skill that provides expert-level Docker configuration validation:
  84. - **Dockerfile Validation**: Syntax, multi-stage builds, security, best practices
  85. - **Docker Compose Validation**: Modern syntax (no obsolete version field), service configuration
  86. - **Security Audit**: Non-root users, exposed secrets, vulnerable base images
  87. - **Multi-Stage Build Verification**: Proper stage implementation and optimization
  88. - **Automation**: Generates validation scripts, CI/CD integrations, pre-commit hooks
  89. - **Comprehensive Reporting**: Detailed issues with fixes, prioritized by severity
  90. **Key Features:**
  91. - Hadolint integration for deep Dockerfile analysis
  92. - DCLint integration for Compose file linting
  93. - Modern Compose syntax enforcement (v2.27.0+)
  94. - Multi-stage build pattern validation
  95. - Security vulnerability identification
  96. - Automated validation script generation
  97. - GitHub Actions and GitLab CI templates
  98. - Complete validation checklists
  99. **When to Use:**
  100. - Validate Dockerfiles before deployment
  101. - Audit Docker security and compliance
  102. - Modernize Docker Compose files
  103. - Review production readiness
  104. - Create automated validation workflows
  105. - Set up CI/CD pipeline validation
  106. - Fix Docker configuration issues
  107. [View Full Documentation](./docker-validation/README.md)
  108. ### 4. Web Design Builder
  109. **Version:** 1.0.0
  110. **Category:** Design
  111. **Description:** Create professional HTML5/JavaScript web designs with Playwright verification
  112. A production-ready skill that generates complete, accessible web designs from specifications:
  113. - **Design Generation**: HTML5, CSS3, JavaScript for any web interface
  114. - **Playwright Integration**: Automatic verification when MCP is available
  115. - **Accessibility Testing**: WCAG 2.1 Level AA compliance checking
  116. - **Visual Verification**: Screenshots at mobile, tablet, desktop breakpoints
  117. - **Functionality Testing**: Forms, interactions, JavaScript validation
  118. - **Performance Analysis**: Load time, resource optimization
  119. - **Framework Support**: Vanilla, Tailwind CSS, React, Vue, Alpine.js
  120. **Key Features:**
  121. - Automatic Playwright MCP detection and graceful fallback
  122. - Responsive, mobile-first designs
  123. - Complete accessibility compliance (WCAG AA)
  124. - Interactive component testing
  125. - Performance metrics and optimization
  126. - Design templates for common patterns
  127. - Comprehensive verification reports
  128. **When to Use:**
  129. - Create landing pages or web applications
  130. - Build responsive web interfaces
  131. - Generate design mockups
  132. - Refactor existing HTML/CSS/JS
  133. - Create accessible WCAG-compliant designs
  134. - Build component libraries
  135. [View Full Documentation](./web-design-builder/README.md)
  136. ### 5. SVG Logo Designer
  137. **Version:** 1.0.0
  138. **Category:** Design
  139. **Description:** Generate professional SVG logos with multiple variations
  140. A production-ready skill that creates scalable vector graphic logos:
  141. - **Multiple Concepts**: 3-5 different design directions per request
  142. - **Layout Variations**: Horizontal, vertical, square, icon-only, text-only
  143. - **Logo Types**: Wordmarks, lettermarks, pictorial, abstract, combination, emblems
  144. - **Color Variations**: Full color, monochrome dark/light, reversed
  145. - **Professional SVG**: Clean, optimized, accessible code
  146. - **Usage Guidelines**: Complete brand identity documentation
  147. - **Export Instructions**: SVG to PNG conversion guidance
  148. **Key Features:**
  149. - Multiple logo concepts exploring different visual approaches
  150. - Comprehensive layout options for all use cases
  151. - Color psychology guidance and palette selection
  152. - Scalable vector graphics work at any size
  153. - Accessibility with title/desc elements
  154. - Complete usage documentation
  155. - File organization and naming conventions
  156. **When to Use:**
  157. - Create brand logos or visual identities
  158. - Design icons or symbols
  159. - Generate logo variations and concepts
  160. - Produce scalable graphics for branding
  161. - Create wordmarks or lettermarks
  162. - Design for both digital and print applications
  163. [View Full Documentation](./svg-logo-designer/README.md)
  164. ### 6. GitLab Stack Validator
  165. **Version:** 1.0.0
  166. **Category:** Development
  167. **Description:** Validates GitLab stack projects before deployment with comprehensive checks
  168. A production-ready skill that validates stack project configurations:
  169. - **Directory Structure**: Required directories (./config, ./secrets, ./_temporary), permissions, .gitignore
  170. - **Environment Variables**: .env and .env.example synchronization (critical requirement)
  171. - **Docker Configuration**: Uses docker-validation skill for compose and Dockerfile checks
  172. - **Secrets Management**: Docker secrets validation, permission checks, exposure detection
  173. - **Configuration Files**: Syntax validation, proper organization, no embedded secrets
  174. - **File Ownership**: Detects root-owned files, ensures proper permissions
  175. - **Scripts**: docker-entrypoint.sh validation when necessary
  176. - **Temporary Files**: ./_temporary directory usage and cleanup validation
  177. **Key Features:**
  178. - Critical .env/.env.example synchronization checking
  179. - Integrates with docker-validation skill for Docker-specific validation
  180. - Comprehensive security scanning for exposed secrets
  181. - File ownership auditing (no root-owned files)
  182. - Detailed, actionable validation reports
  183. - Multiple output formats (text, JSON)
  184. - Strict and permissive validation modes
  185. - Custom validation rules support
  186. - Works with companion skills (stack-creator, secrets-manager)
  187. **When to Use:**
  188. - Validate stack before deployment
  189. - Pre-deployment health checks
  190. - Audit stack configuration and security
  191. - Verify .env and .env.example are in sync
  192. - Check secrets management compliance
  193. - Ensure Docker best practices
  194. - CI/CD pipeline validation gates
  195. - Identify configuration issues early
  196. [View Full Documentation](./stack-validator/README.md)
  197. ### 7. GitLab Stack Secrets Manager
  198. **Version:** 1.0.0
  199. **Category:** Development
  200. **Description:** Secure Docker secrets management - ensures secrets never in .env or docker-compose.yml
  201. A production-ready skill that manages Docker secrets securely:
  202. - **Secret Migration**: Moves secrets from .env and docker-compose.yml to Docker secrets
  203. - **Secret Creation**: Generates secure random secrets with proper permissions
  204. - **Validation**: Detects secrets in wrong locations (critical security issue)
  205. - **Auditing**: Find leaks, unused secrets, permission issues
  206. - **Git Protection**: Ensures secrets never committed to version control
  207. - **docker-entrypoint.sh**: Generates entrypoint scripts when containers lack native support
  208. **Key Features:**
  209. - Critical security focus: NO secrets in .env or docker-compose.yml environment
  210. - Automatic migration from insecure locations
  211. - Secure random secret generation (alphanumeric, hex, base64, UUID)
  212. - Comprehensive leak detection across .env, compose, config files, git history
  213. - File permission management (700/600)
  214. - Integration with stack-validator for security checks
  215. - Works with stack-creator for proper initialization
  216. **When to Use:**
  217. - Fix "secrets in .env" security issues
  218. - Migrate environment variables to Docker secrets
  219. - Create new secure secrets
  220. - Validate secret configuration
  221. - Audit secret usage and detect leaks
  222. - Generate docker-entrypoint.sh for legacy containers
  223. - Rotate existing secrets
  224. - Ensure secrets not in git
  225. [View Full Documentation](./secrets-manager/README.md)
  226. ### 8. GitLab Stack Config Generator
  227. **Version:** 1.0.0
  228. **Category:** Development
  229. **Description:** Service configuration generator using .env as primary config source
  230. A production-ready skill that generates service configurations:
  231. - **Service Templates**: Nginx (3 variants), PostgreSQL (3 variants), Redis (3 variants)
  232. - **Meta Files**: CLAUDE.md (with commit rules), .gitignore, .dockerignore
  233. - **Configuration Source**: .env as single source of truth (not separate env files)
  234. - **Directory Structure**: Service-specific directories (./config/service-name/)
  235. - **Strict Validation**: No secrets in configs, .env/.env.example sync, path validation
  236. - **Docker Integration**: Uses docker-validation skill for all Docker configs
  237. **Key Features:**
  238. - User-selectable template defaults (production, development, custom)
  239. - Flat config structure inside each service directory
  240. - Environment variable placeholders in all configs
  241. - Critical .env and .env.example synchronization
  242. - Secret detection with secrets-manager integration
  243. - Path validation (all referenced paths must exist)
  244. - Syntax validation per service type
  245. - Meta files with proper git exclusions
  246. **When to Use:**
  247. - Generate service configurations (nginx, PostgreSQL, Redis)
  248. - Set up project meta files (CLAUDE.md, .gitignore, .dockerignore)
  249. - Create config templates for new services
  250. - Ensure configs use .env variables correctly
  251. - Validate existing configurations
  252. - Sync .env and .env.example
  253. [View Full Documentation](./config-generator/README.md)
  254. ### 9. Newt Blueprint Generator
  255. **Version:** 1.0.0
  256. **Category:** Development
  257. **Description:** Generate and validate Pangolin Newt blueprint configurations
  258. A production-ready skill that creates Pangolin Newt blueprints:
  259. - **Blueprint Formats**: YAML configuration files and Docker Compose labels
  260. - **Proxy Resources**: HTTP (domain-based), TCP/UDP (port-based) resource configurations
  261. - **Client Resources**: Olm client resources for SSH, RDP, and other protocols
  262. - **Authentication**: SSO, basic auth, pincode, and password authentication
  263. - **Access Control**: IP, CIDR, path, and country-based rules
  264. - **Validation**: Comprehensive validation with helpful error messages
  265. **Key Features:**
  266. - Support for both YAML and Docker Labels format
  267. - Protocol-specific validation (HTTP vs TCP/UDP requirements)
  268. - Authentication configuration with SSO role/user management
  269. - Multi-target load balancing support
  270. - Path-based routing with prefix/exact/regex matching
  271. - Custom header injection
  272. - Targets-only resource configuration for simplified setups
  273. - Detailed validation error explanations
  274. - Best practices and security recommendations
  275. **When to Use:**
  276. - Create Pangolin blueprint configurations
  277. - Expose web applications via domain names (HTTP)
  278. - Expose databases or other services via ports (TCP/UDP)
  279. - Configure Olm client resources
  280. - Set up authentication and access control
  281. - Validate existing blueprint configurations
  282. - Convert between YAML and Docker Labels formats
  283. - Troubleshoot blueprint validation errors
  284. [View Full Documentation](./newt-blueprint-generator/README.md)
  285. ### 10. GitLab Stack Creator
  286. **Version:** 1.0.0
  287. **Category:** Development
  288. **Description:** Create new GitLab stack projects with complete validation
  289. A production-ready skill that creates GitLab stack projects from scratch:
  290. - **Directory Structure**: Proper ./config, ./secrets, ./_temporary, ./scripts, ./docs setup
  291. - **Git Configuration**: Initializes repository with main branch and ff-only merge strategy
  292. - **Validation Scripts**: Creates validate-stack.sh, pre-commit hooks, setup-hooks.sh
  293. - **Docker Configuration**: Generates docker-compose.yml validated by docker-validation skill
  294. - **Secrets Management**: Integrates secrets-manager for secure secret handling
  295. - **Service Configs**: Uses config-generator for nginx, PostgreSQL, Redis configurations
  296. - **Documentation**: Generates README.md, CLAUDE.md, setup.md, services.md, ADRs
  297. **Key Features:**
  298. - Integrates stack-validator, secrets-manager, docker-validation, config-generator skills
  299. - Never uses workarounds - always asks user for guidance when stuck
  300. - Complete only when ALL validators pass with NO issues
  301. - Git hooks for pre-commit validation (blocks commits if validation fails)
  302. - Comprehensive templates for common stacks (web, full-stack)
  303. - Architecture decision records in ./docs/decisions/
  304. - ff-only merge strategy for clean git history
  305. - main as default branch name
  306. - All scripts executable and ready to use
  307. **When to Use:**
  308. - Create new GitLab stack project from scratch
  309. - Initialize Docker stack with proper structure
  310. - Set up project with validation from the start
  311. - Bootstrap production-ready stack following best practices
  312. - Need git repository with validation hooks
  313. - Want complete documentation generated automatically
  314. **Completion Criteria:**
  315. A stack is complete ONLY when:
  316. - ✅ stack-validator reports NO issues
  317. - ✅ secrets-manager is satisfied (NO open issues)
  318. - ✅ docker-validation is satisfied (NO issues)
  319. - ✅ All validation scripts execute successfully
  320. - ✅ Git repository properly initialized and configured
  321. - ✅ Documentation complete in ./docs
  322. [View Full Documentation](./stack-creator/README.md)
  323. ## Repository Structure
  324. ```
  325. Skills/
  326. ├── .claude-plugin/
  327. │ └── marketplace.json # Marketplace configuration
  328. ├── python-architecture-review/ # Python Backend Architecture Review Skill
  329. │ ├── SKILL.md # Main skill definition
  330. │ ├── README.md # Skill documentation
  331. │ ├── architecture-checklist.md # Complete review checklist
  332. │ ├── common-patterns.md # Reference implementations
  333. │ └── technology-recommendations.md # Tech stack guide
  334. ├── ui-design-review/ # UI/UX Design Review Skill
  335. │ ├── SKILL.md # Main skill definition
  336. │ ├── README.md # Skill documentation
  337. │ ├── wcag-checklist.md # WCAG 2.1/2.2 compliance checklist
  338. │ ├── design-patterns-library.md # Accessible component patterns
  339. │ └── testing-resources.md # Testing tools and methods
  340. ├── docker-validation/ # Docker Configuration Validator Skill
  341. │ ├── SKILL.md # Main skill definition
  342. │ ├── README.md # Skill documentation
  343. │ ├── validation-checklist.md # Complete validation checklist
  344. │ └── tool-installation.md # Tool setup guide
  345. ├── web-design-builder/ # Web Design Builder Skill
  346. │ ├── SKILL.md # Main skill definition
  347. │ ├── README.md # Skill documentation
  348. │ └── design-templates.md # Ready-to-use templates
  349. ├── svg-logo-designer/ # SVG Logo Designer Skill
  350. │ ├── SKILL.md # Main skill definition
  351. │ └── README.md # Skill documentation
  352. ├── stack-validator/ # GitLab Stack Validator Skill
  353. │ ├── SKILL.md # Main skill definition
  354. │ ├── README.md # Skill documentation
  355. │ ├── validation-patterns.md # Architecture patterns and examples
  356. │ └── common-issues.md # Issue reference guide
  357. ├── secrets-manager/ # GitLab Stack Secrets Manager Skill
  358. │ ├── SKILL.md # Main skill definition
  359. │ ├── README.md # Skill documentation
  360. │ ├── secrets-patterns.md # Security patterns and best practices
  361. │ └── migration-guide.md # Step-by-step migration scenarios
  362. ├── config-generator/ # GitLab Stack Config Generator Skill
  363. │ ├── SKILL.md # Main skill definition
  364. │ ├── README.md # Skill documentation
  365. │ ├── service-templates.md # Service templates (nginx, postgres, redis)
  366. │ └── validation-rules.md # Validation rules reference
  367. ├── newt-blueprint-generator/ # Newt Blueprint Generator Skill
  368. │ ├── SKILL.md # Main skill definition
  369. │ ├── README.md # Skill documentation
  370. │ └── validation-reference.md # Validation rules reference
  371. ├── stack-creator/ # GitLab Stack Creator Skill
  372. │ ├── SKILL.md # Main skill definition
  373. │ ├── README.md # Skill documentation
  374. │ ├── git-hooks-guide.md # Git hooks and validation scripts
  375. │ ├── templates-reference.md # docker-compose and config templates
  376. │ └── workflow-examples.md # Example workflows
  377. └── README.md # This file
  378. ```
  379. ## Creating Your Own Skills
  380. ### Quick Start
  381. 1. Create a new directory for your skill:
  382. ```bash
  383. mkdir my-new-skill
  384. cd my-new-skill
  385. ```
  386. 2. Create a `SKILL.md` file with YAML frontmatter:
  387. ```markdown
  388. ---
  389. name: "My Skill Name"
  390. description: "What this skill does and when to use it"
  391. ---
  392. # My Skill Name
  393. ## Instructions
  394. [Your skill instructions here...]
  395. ```
  396. 3. Add your skill to `.claude-plugin/marketplace.json`:
  397. ```json
  398. {
  399. "plugins": [
  400. {
  401. "name": "my-new-skill",
  402. "source": "./my-new-skill",
  403. "description": "Description of my skill",
  404. "version": "1.0.0"
  405. }
  406. ]
  407. }
  408. ```
  409. 4. Test your skill locally by installing it:
  410. ```bash
  411. /plugin install my-new-skill
  412. ```
  413. ### Skill Best Practices
  414. 1. **Clear Description**: Make sure your description explains both what the skill does AND when Claude should use it
  415. 2. **Comprehensive Instructions**: Provide detailed, step-by-step guidance
  416. 3. **Examples**: Include example usage and code snippets where relevant
  417. 4. **Reference Resources**: Add supporting documents (checklists, patterns, etc.)
  418. 5. **Version Control**: Update version numbers when making changes
  419. ### Skill Components
  420. A well-structured skill can include:
  421. - `SKILL.md` - Main skill definition (required)
  422. - `README.md` - User-facing documentation
  423. - Supporting markdown files - Reference materials, checklists, patterns
  424. - Scripts or templates - Reusable code or configuration
  425. - Examples - Sample inputs/outputs
  426. ## Using Skills in Your Projects
  427. ### Repository-Level Configuration
  428. To ensure your team uses the same skills, add a `.claude/config.json` to your project repository:
  429. ```json
  430. {
  431. "marketplaces": [
  432. "rknall/Skills"
  433. ],
  434. "plugins": [
  435. "python-architecture-review"
  436. ]
  437. }
  438. ```
  439. When team members trust your repository folder, Claude Code will automatically install these marketplaces and plugins.
  440. ### Local Testing
  441. Before publishing, test your skills locally:
  442. 1. Copy the skill directory to `~/.claude/skills/`
  443. 2. Restart Claude Code or run `/reload`
  444. 3. Trigger the skill by asking Claude to perform the relevant task
  445. ## Marketplace Configuration
  446. The `.claude-plugin/marketplace.json` file defines this marketplace:
  447. ```json
  448. {
  449. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  450. "name": "rknall-custom-skills",
  451. "version": "1.0.0",
  452. "description": "Custom Claude Code skills marketplace for advanced development workflows",
  453. "owner": {
  454. "name": "rknall"
  455. },
  456. "plugins": [...]
  457. }
  458. ```
  459. ## Distribution
  460. This marketplace can be distributed via:
  461. - GitHub repository (recommended)
  462. - GitLab repository
  463. - Any git hosting service
  464. - Direct URL to git repository
  465. Users install it with a single command:
  466. ```bash
  467. /plugin marketplace add rknall/Skills
  468. ```
  469. ## Version History
  470. ### 0.6.2 (2025-10-20)
  471. - Added GitLab Stack Config Generator skill v1.0.0
  472. - Service-specific configuration generation for GitLab stack projects
  473. - .env as primary configuration source (single source of truth)
  474. - Service templates: Nginx (3 variants), PostgreSQL (3 variants), Redis (3 variants)
  475. - Meta files generation: CLAUDE.md (with commit message rules), .gitignore, .dockerignore
  476. - User-selectable template defaults (production, development, custom)
  477. - Strict .env and .env.example synchronization checking
  478. - Secret detection with secrets-manager integration
  479. - Path validation for all referenced files and directories
  480. - Docker validation using docker-validation skill (always)
  481. - Comprehensive service templates with complete examples
  482. ### 0.6.1 (2025-10-20)
  483. - Added GitLab Stack Secrets Manager skill v1.0.0
  484. - Secure Docker secrets management for GitLab stack projects
  485. - Critical focus: ensures secrets NEVER in .env or docker-compose.yml
  486. - Automatic migration from insecure locations
  487. - Secret creation with secure random generation (alphanumeric, hex, base64, UUID)
  488. - Comprehensive validation and leak detection
  489. - docker-entrypoint.sh generation for legacy containers
  490. - File permission management (700/600)
  491. - Git protection and history scanning
  492. - Integration with stack-validator for security checks
  493. - Complete migration guide with step-by-step scenarios
  494. ### 0.6.0 (2025-10-20)
  495. - Added GitLab Stack Validator skill v1.0.0
  496. - Comprehensive stack project validation before deployment
  497. - Critical .env and .env.example synchronization checking
  498. - Directory structure, secrets management, and ownership validation
  499. - Integrates with docker-validation skill for Docker-specific checks
  500. - Multiple validation modes (standard, strict, permissive)
  501. - JSON and text output formats for CI/CD integration
  502. - Works with companion skills: stack-creator and secrets-manager
  503. - Complete validation patterns and common issues reference guides
  504. ### 0.5.0 (2025-10-18)
  505. - Added Docker Configuration Validator skill v1.0.0
  506. - Comprehensive Dockerfile and Docker Compose validation
  507. - Modern Compose syntax enforcement (no obsolete version field)
  508. - Multi-stage build verification
  509. - Security audit capabilities
  510. - Hadolint and DCLint integration
  511. - Automated validation script generation
  512. - CI/CD integration templates (GitHub Actions, GitLab CI)
  513. - Complete validation checklists and tool installation guides
  514. ### 0.4.0 (2025-10-18)
  515. - Added Web Design Builder skill v1.0.0
  516. - HTML5/JavaScript design generation
  517. - Playwright MCP integration for automatic verification
  518. - Accessibility, visual, and functionality testing
  519. - Multiple framework support (Vanilla, Tailwind, React, Vue, Alpine.js)
  520. - Design templates for common patterns
  521. - Added SVG Logo Designer skill v1.0.0
  522. - Professional logo generation with multiple concepts
  523. - Layout variations (horizontal, vertical, square, icon, text)
  524. - All major logo types supported
  525. - Color psychology guidance
  526. - Complete usage guidelines
  527. ### 0.2.0 (2025-10-18)
  528. - Added UI/UX Design Review skill v1.0.0
  529. - Comprehensive WCAG 2.1/2.2 compliance framework
  530. - Accessible component pattern library
  531. - Visual design and UX evaluation
  532. - Testing tools and resources guide
  533. ### 0.1.0 (2025-10-18)
  534. - Initial marketplace setup
  535. - Python Backend Architecture Review skill v1.0.0
  536. - Comprehensive review framework
  537. - 12+ architectural patterns
  538. - Technology recommendations for 2025
  539. - Complete architecture checklist
  540. ## Contributing
  541. To add or improve skills in this marketplace:
  542. 1. Create or modify the skill in its directory
  543. 2. Update the skill's README.md with documentation
  544. 3. Update marketplace.json with any new skills
  545. 4. Update version numbers appropriately
  546. 5. Test locally before committing
  547. ## Future Skills
  548. Planned skills for future releases:
  549. - Frontend Architecture Review (React/Vue/Angular)
  550. - Infrastructure as Code Review (Terraform/CloudFormation)
  551. - Kubernetes Configuration Validator (manifest validation, best practices)
  552. - Security Audit Skill (penetration testing, threat modeling)
  553. - Performance Optimization Skill (profiling, benchmarking)
  554. - Database Schema Review Skill
  555. - API Design Review Skill (REST, GraphQL, gRPC)
  556. - Microservices Architecture Skill
  557. - Code Quality Review Skill (refactoring, technical debt)
  558. - Documentation Review Skill (technical writing, API docs)
  559. ## Support
  560. For issues, questions, or suggestions:
  561. - Open an issue in this repository
  562. - Contact the maintainer directly
  563. ## Resources
  564. - [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code)
  565. - [Skills Documentation](https://docs.claude.com/en/docs/claude-code/skills)
  566. - [Plugin Marketplace Documentation](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces)
  567. ## License
  568. These skills are provided as-is for use with Claude Code. Individual skills may have their own licensing terms.
  569. ---
  570. **Marketplace Version:** 0.6.2
  571. **Last Updated:** 2025-10-20
  572. **Maintainer:** rknall

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.