teach-impeccable

Gathers project design context and persists it to an AI config file.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI assistants start every session without knowledge of your project's design direction, leading to inconsistent UI decisions. This Skill runs a one-time setup that captures your brand personality, aesthetic preferences, and accessibility requirements, then saves them as persistent design guidelines. ## Core Features & Use Cases - Codebase Exploration: Scans README, package.json, components, brand assets, and CSS variables to infer existing design patterns before asking questions. - Guided Questioning: Asks focused follow-up questions about users, brand personality, aesthetic direction, and accessibility needs only where the codebase leaves gaps. - Persistent Design Context: Writes a structured Design Context section to .impeccable.md and optionally appends it to AGENTS.md so all future sessions follow the same principles. - Use Case: A developer starting a new web app runs this once; every subsequent AI-assisted design task then follows the documented brand personality, theme preferences, and design principles automatically. ## Quick Start Ask the assistant to run the teach-impeccable setup to gather design context and save it to your project config.

Frequently Asked Questions about teach-impeccable

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

FAQPage Schema
How do I set up persistent design guidelines for AI coding assistants?

Run this Skill once in your project. It scans your codebase for existing design signals, asks targeted questions about brand and users, then writes a Design Context section to .impeccable.md and optionally AGENTS.md for all future sessions.

What questions does the 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 needs.

Does the design context setup scan my existing codebase first?

Yes. Before asking questions, it explores the README, package.json, existing components, brand assets, and CSS variables or design tokens. It skips questions whose answers are already clear from the codebase.

Where is the design context saved after setup?

The synthesized 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 AGENTS.md after confirming.

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

No, it is designed as a one-time setup. The saved Design Context persists in your project files and guides all future sessions. Re-run it only if your brand direction or accessibility requirements change.