teach-impeccable

Gathers project design context through codebase exploration and user questions, then persists it to a config file.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/WeWake1/BSOMS --skill teach-impeccable-wewake1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: teach-impeccable
Source: https://github.com/WeWake1/BSOMS/tree/main/.agents/skills/teach-impeccable
Command: npx skills add https://github.com/WeWake1/BSOMS --skill teach-impeccable-wewake1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI assistants start every session without knowledge of your project's design intent, leading to generic or inconsistent UI output. This Skill runs a one-time setup that captures your users, brand personality, and aesthetic direction, then saves it as persistent design guidelines for all future sessions. ## Core Features & Use Cases - Codebase Discovery: Scans README, package.json, components, brand assets, and CSS variables to infer existing design patterns before asking anything. - Targeted Questioning: Asks only about what could not be inferred, covering users, brand personality, aesthetic preferences, and accessibility requirements. - Persistent Design Context: Writes a structured Design Context section to .impeccable.md and optionally appends it to CLAUDE.md. - Use Case: A team starting a new Next.js dashboard runs this once so every subsequent AI-generated component follows the same brand tone, color direction, and accessibility standards. ## Quick Start Ask the AI to run the teach-impeccable setup to establish design guidelines for this project.

Frequently Asked Questions about teach-impeccable

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I give my AI assistant persistent design guidelines for a project?▼

Run this one-time setup skill, which explores your codebase, asks targeted questions about users and brand, then writes a Design Context section to .impeccable.md. Future sessions read this file to stay consistent.

What questions does a design context setup ask?▼

It asks about users and their goals, brand personality in three words, reference and anti-reference sites, visual direction preferences, light or dark mode, color constraints, and accessibility requirements such as WCAG level or reduced motion.

Does the design context setup scan my existing codebase first?▼

Yes. It scans the README, package.json, existing components, brand assets, and CSS variables or design tokens before asking questions, skipping anything it can already infer from the code.

Where is the design context saved after setup?▼

The Design Context section is written to .impeccable.md in the project root, updating the section in place if the file exists. You can optionally also append it to CLAUDE.md.

Do I need to run the design context setup more than once?▼

No, it is designed as a one-time setup. You only rerun it if your brand direction, target users, or accessibility requirements change significantly.