Skip to content

w159/carlos-code

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—οΈ Carlos Code β€” Personal Plugin Marketplace

A personal plugin marketplace and skill library for full-stack web application development, built on the Impeccable design language with enterprise-grade development patterns.


πŸ“‹ Table of Contents


Overview

This marketplace bundles 24 skills into a single plugin for Claude Code / Cowork:

  • 17 Impeccable design commands β€” audit, polish, normalize, animate, and more for frontend design quality
  • 7 design reference documents β€” typography, color, spatial design, motion, interaction, responsive, UX writing
  • 6 custom enterprise skills β€” progress modals, full-stack architecture, frontend refactoring, codebase refactoring, README generation, and multi-phase refactoring plans

Quick Start

Use with Claude Code (project-specific)

cp -r plugins/impeccable-fullstack/skills/* your-project/.claude/skills/

Use with Claude Code (global)

cp -r plugins/impeccable-fullstack/skills/* ~/.claude/skills/

Use with Cowork

The plugins/impeccable-fullstack/ directory is ready to use as a skill source. Point your Cowork session's skill path to this directory.


Plugin: impeccable-fullstack

πŸ“¦ Plugin Metadata
Field Value
Name impeccable-fullstack
Version 1.0.0
Author Jerry
License Apache-2.0 (Impeccable base) + Personal (custom skills)
Based On pbakaus/impeccable
Total Skills 24

Directory Structure

carlos-code/
β”œβ”€β”€ CLAUDE.md                              # Marketplace manifest & dev preferences
β”œβ”€β”€ README.md                              # This file
β”œβ”€β”€ .claude/
β”‚   └── skills/
β”‚       └── impeccable-fullstack/
β”‚           └── SKILL.md                   # Meta-skill (command reference)
β”‚
β”œβ”€β”€ plugins/
β”‚   └── impeccable-fullstack/
β”‚       β”œβ”€β”€ plugin.json                    # Plugin configuration
β”‚       β”œβ”€β”€ NOTICE.md                      # Licensing & attribution
β”‚       └── skills/
β”‚           β”‚
β”‚           β”‚  ── Impeccable Design Skills (from pbakaus/impeccable) ──
β”‚           β”‚
β”‚           β”œβ”€β”€ frontend-design/           # Core design skill + 7 reference docs
β”‚           β”‚   β”œβ”€β”€ SKILL.md               # Design direction, aesthetics, anti-patterns
β”‚           β”‚   └── reference/
β”‚           β”‚       β”œβ”€β”€ typography.md       # Type systems, font pairing, modular scales
β”‚           β”‚       β”œβ”€β”€ color-and-contrast.md  # OKLCH, tinted neutrals, dark mode
β”‚           β”‚       β”œβ”€β”€ spatial-design.md   # Spacing systems, grids, visual hierarchy
β”‚           β”‚       β”œβ”€β”€ motion-design.md    # Easing curves, staggering, reduced motion
β”‚           β”‚       β”œβ”€β”€ interaction-design.md  # Forms, focus states, loading patterns
β”‚           β”‚       β”œβ”€β”€ responsive-design.md   # Mobile-first, fluid, container queries
β”‚           β”‚       └── ux-writing.md       # Button labels, errors, empty states
β”‚           β”‚
β”‚           β”œβ”€β”€ audit/SKILL.md             # Technical quality audit
β”‚           β”œβ”€β”€ polish/SKILL.md            # Final pre-ship quality pass
β”‚           β”œβ”€β”€ normalize/SKILL.md         # Align with design system standards
β”‚           β”œβ”€β”€ animate/SKILL.md           # Add purposeful motion
β”‚           β”œβ”€β”€ harden/SKILL.md            # Error handling, i18n, resilience
β”‚           β”œβ”€β”€ distill/SKILL.md           # Strip to essence
β”‚           β”œβ”€β”€ clarify/SKILL.md           # Improve UX copy clarity
β”‚           β”œβ”€β”€ colorize/SKILL.md          # Introduce strategic color
β”‚           β”œβ”€β”€ critique/SKILL.md          # UX design review
β”‚           β”œβ”€β”€ delight/SKILL.md           # Add joy moments
β”‚           β”œβ”€β”€ extract/SKILL.md           # Pull into reusable components
β”‚           β”œβ”€β”€ adapt/SKILL.md             # Adapt for different devices
β”‚           β”œβ”€β”€ onboard/SKILL.md           # Design onboarding flows
β”‚           β”œβ”€β”€ optimize/SKILL.md          # Performance improvements
β”‚           β”œβ”€β”€ bolder/SKILL.md            # Amplify bland designs
β”‚           β”œβ”€β”€ quieter/SKILL.md           # Tone down aggressive designs
β”‚           β”œβ”€β”€ teach-impeccable/SKILL.md  # One-time design context setup
β”‚           β”‚
β”‚           β”‚  ── Custom Enterprise Skills ──
β”‚           β”‚
β”‚           β”œβ”€β”€ progress-modal/SKILL.md    # Multi-step progress modal component
β”‚           β”œβ”€β”€ enterprise-webapp/SKILL.md # Full-stack enterprise architecture
β”‚           β”œβ”€β”€ frontend-refactor/SKILL.md # shadcn/ui + Tailwind refactoring
β”‚           β”œβ”€β”€ codebase-refactor/SKILL.md # SOLID refactoring with naming rules
β”‚           β”œβ”€β”€ readme-generator/SKILL.md  # Enterprise README.md generation
β”‚           └── refactoring-plan/SKILL.md  # Multi-phase refactoring with gates
β”‚
└── prompts/                               # (Reserved for raw prompt storage)

Available Skills & Commands

🎨 Impeccable Design Commands

These commands focus on frontend design quality and come from the Impeccable project:

Command Purpose When to Use
/teach-impeccable One-time setup β€” gather design context First time with a project
/audit Technical quality audit (a11y, perf, responsive) Before shipping, periodic reviews
/critique UX design review When evaluating design decisions
/normalize Align with design system standards Inconsistent styling
/polish Final pre-ship quality pass Last step before shipping
/distill Strip to essence Overdesigned interfaces
/clarify Improve UX copy clarity Confusing labels or messages
/optimize Performance improvements Slow pages, heavy bundles
/harden Error handling, i18n, resilience Edge cases, internationalization
/animate Add purposeful motion Static, lifeless interfaces
/colorize Introduce strategic color Bland or monotone designs
/bolder Amplify bland designs Too safe, too generic
/quieter Tone down aggressive designs Too loud, overstimulating
/delight Add joy moments Functional but lifeless
/extract Pull into reusable components Code duplication
/adapt Adapt for different devices Mobile/tablet gaps
/onboard Design onboarding flows First-time user experience

🏒 Custom Enterprise Skills

These skills extend Impeccable with full-stack enterprise development patterns:

Skill Purpose Covers
/progress-modal Build multi-step progress modal TypeScript API, backend contract, WCAG 2.1 AA, cancellation, testing
/enterprise-webapp Full-stack enterprise guide Frontend, backend, auth, caching, async, security, observability, CI/CD
/frontend-refactor Refactor to shadcn/ui Design tokens, atomic design, feedback tiers, dark mode, 10-step process
/codebase-refactor Systematic refactoring SOLID, banned naming patterns, DRY, mirrored structure, 9-step process
/readme-generator Generate README.md 19 sections, collapsible deep-dives, external references, quality bar
/refactoring-plan Multi-phase refactoring 5 phases with validation gates, rollback protocols, success criteria

πŸ“š Design Reference Documents

The frontend-design skill includes 7 reference documents consulted automatically:

Reference What It Covers
typography.md Type scales, font pairing, fluid sizing, OpenType features, loading strategies
color-and-contrast.md OKLCH color, tinted neutrals, dark mode, accessibility contrast ratios
spatial-design.md Spacing systems, grids, visual rhythm, container queries
motion-design.md Timing, easing curves (no bounce/elastic), staggering, reduced motion
interaction-design.md Forms, focus management, loading patterns, optimistic UI
responsive-design.md Mobile-first, fluid design, container queries, adaptive layouts
ux-writing.md Button labels, error messages, empty states, microcopy

Usage Guide

Typical Workflow

1. /teach-impeccable     ← Establish design context (once per project)
2. Build features         ← Use enterprise-webapp for architecture guidance
3. /audit                ← Find quality issues
4. /normalize            ← Fix inconsistencies
5. /polish               ← Final quality pass

For New Projects

/teach-impeccable        ← Set design direction
/enterprise-webapp       ← Reference architecture patterns

For Refactoring

/codebase-refactor       ← Systematic SOLID refactoring
/frontend-refactor       ← Migrate to shadcn/ui
/refactoring-plan        ← Multi-phase plan with gates

For Documentation

/readme-generator        ← Generate comprehensive README.md

For Component Development

/progress-modal          ← Build progress feedback components
/extract                 ← Pull into reusable components
/animate                 ← Add purposeful motion
/harden                  ← Add error handling and resilience

Development Preferences

These preferences are encoded in CLAUDE.md and apply to all projects using this marketplace:

Preference Setting
Python packages UV with .venv.nosync.noindex naming
Node.js packages Yarn (not NPM β€” avoids large node_modules churn)
Code comments Clear section comments explaining different areas
Process Research β†’ Check docs β†’ Test β†’ Validate before implementing
Changes Small incremental changes with repeated testing

Attribution

Impeccable

The design skills in this plugin are based on Impeccable by Paul Bakaus, licensed under Apache 2.0. Impeccable itself builds on Anthropic's frontend-design skill.

Custom Skills

The enterprise development skills (progress-modal, enterprise-webapp, frontend-refactor, codebase-refactor, readme-generator, refactoring-plan) are original works.


Sources:

About

The harder working version of claude

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors