teach-impeccable

Overview

What is teach-impeccable?

teach-impeccable is a one-time setup skill designed to help you gather and document the essential design context for your project. By running this skill, you create a persistent record of your project's visual and UX guidelines, which is saved to your AI config file. This ensures that your design principles are clear, consistent, and easily referenced by your team or AI agents in future sessions.

Who should use teach-impeccable?

This skill is ideal for UI designers, product teams, and developers who want to establish a strong, consistent design foundation for their projects. If you need to onboard new team members, maintain design quality, or ensure that your project's visual direction is well-documented, teach-impeccable is a practical choice.

Problems it solves

• Prevents design drift by persisting guidelines
• Makes onboarding easier by documenting design context
• Reduces ambiguity in visual and UX decisions
• Centralizes brand and aesthetic preferences

How to Use

Installation Steps

1. Install the skill using the following command:

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

2. Begin with the SKILL.md file to understand the workflow and requirements.
3. Review supporting files such as README.md, AGENTS.md, metadata.json, and any folders like rules/, resources/, or references/ for additional context.

Setting Up Your Design Context

• Explore your codebase: Review documentation, config files, existing components, and brand assets to gather all available design information.
• Ask targeted questions: Use the workflow to clarify user needs, brand personality, and aesthetic preferences that aren't obvious from the codebase.
• Document findings: Persist your answers and discoveries in your AI config file to establish a reference for future work.

Best Practices

• Adapt the workflow to fit your repository and team processes.
• Use teach-impeccable as an initial setup step for new projects or major redesigns.
• Revisit and update your design context as your project evolves.

FAQ

When should I use teach-impeccable?

Use teach-impeccable at the start of a new project or when you need to formalize design guidelines. It's especially useful before onboarding new team members or launching a redesign.

What files are most important to review?

Start with SKILL.md for the main workflow. Supporting files like README.md and metadata.json provide additional context.

Can I customize the workflow?

Yes. The teach-impeccable skill is designed to be adapted to your team's needs, tools, and repository structure.

Where can I find more details?

Explore the Files tab in the repository to view the full file tree, including references and helper scripts for deeper guidance.