teach-impeccable

Overview

What is teach-impeccable?

teach-impeccable is a UI design skill that helps you capture and persist your project's design context, including brand assets, design tokens, and UX preferences. By running it once, you create a foundation for consistent interface aesthetics and design direction across your team or future sessions.

Who should use teach-impeccable?

This skill is ideal for designers, developers, and product teams who want to establish clear, persistent design guidelines. It's especially useful when starting a new project, onboarding collaborators, or formalizing a design system.

What problems does it solve?

• Prevents design drift by documenting visual standards early
• Makes brand assets and design tokens easy to reference
• Streamlines onboarding by clarifying UX and brand expectations
• Supports consistent UI design across multiple contributors

How to Use

Installation Steps

1. Install teach-impeccable using:

   npx skills add https://github.com/pbakaus/impeccable --skill teach-impeccable
   

2. Review the SKILL.md file for step-by-step guidance.

Initial Setup Workflow

• Explore your codebase: Check README.md, package.json, design libraries, and existing components for current design patterns and assets.
• Identify brand assets: Locate logos, color palettes, and style guides.
• Document design tokens: Note CSS variables, font stacks, and spacing scales.
• Clarify unclear areas: Ask targeted UX questions about users, brand personality, and aesthetic preferences.

Persisting Design Context

teach-impeccable saves your design context to your AI config file, making it accessible for all future sessions and collaborators.

Recommended Files to Review

• Start with SKILL.md for the main workflow
• Optionally inspect README.md, AGENTS.md, and metadata.json for supporting context

FAQ

Is teach-impeccable suitable for all projects?

teach-impeccable is best for projects where UI consistency and design system clarity are priorities. If your project has minimal design requirements or you don't need persistent guidelines, it may not be necessary.

Can I customize the workflow?

Yes. Adapt the teach-impeccable workflow to fit your repository structure, tools, and team needs. The skill provides a flexible framework for gathering and documenting design context.

Where can I find supporting files and scripts?

Open the Files tab in the repository to view the full file tree, including nested references and helper scripts for deeper context.

How often should I run teach-impeccable?

Run teach-impeccable once at project setup, and again if major design changes occur or new collaborators join.