teach-impeccable

Overview

teach-impeccable is a UI design skill that helps you capture, document, and persist your project's design context and guidelines in your AI config file. This one-time setup ensures your design standards are clearly defined and consistently referenced by your team and AI agents. It's especially useful for projects seeking to establish or maintain a unified UI design language.

What does teach-impeccable do?

• Gathers essential design context from your codebase and documentation
• Prompts you with targeted UX and brand questions to fill in gaps
• Saves the resulting guidelines to your AI config for future reference

Who should use this skill?

• UI/UX designers, front-end developers, and project maintainers
• Teams starting a new project or formalizing design standards
• Anyone wanting to ensure design consistency across AI-assisted workflows

Problems teach-impeccable solves

• Reduces ambiguity in UI design decisions
• Makes design context accessible for all contributors and AI tools
• Prevents design drift by persisting guidelines

How to Use

Installation steps

1. Add the skill to your project with:

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

2. Review the SKILL.md file for a guided workflow and checklist.

Initial setup process

• Explore your codebase and documentation to collect existing design context (see README.md, package.json, style guides, and brand assets).
• Use the skill's prompts to clarify user needs, brand personality, and aesthetic preferences.
• Document your findings and answers in your AI config file as directed.

Best practices

• Involve both designers and developers in the setup for comprehensive coverage.
• Revisit and update your design context as your project evolves.

When is teach-impeccable a good fit?

• When starting a new UI project or onboarding new team members
• When you need to formalize or update design guidelines
• For projects using AI agents that benefit from persistent design context

When might it not be suitable?

• For projects with no UI or design requirements
• If you already have a robust, enforced design system and config

FAQ

Where can I find the main workflow and checklist?

Check the SKILL.md file in the skill directory for a step-by-step guide.

What files should I review first?

Start with SKILL.md, then review any README.md, AGENTS.md, metadata.json, and supporting folders like rules/ or resources/ for additional context.

Does teach-impeccable enforce design decisions?

No, it helps you document and persist guidelines, but does not enforce them automatically.

Can I update the design context later?

Yes, rerun the workflow or manually update your AI config file as your project evolves.

Where can I see all related files?

Open the Files tab in your repository to browse the full file tree, including references and helper scripts.