skills.rest
oliverjone01-dev
oliverjone01-devCOMMUNITY
Explore all skills by this author →
GitHub

teach-impeccable

Capture project design context and persist it to .impeccable.md.

1|Updated Apr 16, 2026
Search Tags:#accessibility#brand guidelines#claude.md#aesthetic direction#design context#ux discovery
One-click install
npx skills add https://github.com/oliverjone01-dev/t1 --skill teach-impeccable-oliverjone01-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: teach-impeccable
Source: https://github.com/oliverjone01-dev/t1/tree/main/.claude/skills/teach-impeccable
Command: npx skills add https://github.com/oliverjone01-dev/t1 --skill teach-impeccable-oliverjone01-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams establish a durable design baseline for a project by gathering UX, brand, and aesthetic context once and saving it for future AI sessions.

Core Features & Use Cases

  • Project Discovery: Scans the codebase for README files, config, existing components, design tokens, and brand assets to infer the current visual direction.
  • UX Questioning: Asks only the questions that cannot be answered from the repository, focusing on users, purpose, brand personality, visual preferences, and accessibility needs.
  • Persistent Design Notes: Writes a structured Design Context section to .impeccable.md and can optionally mirror it into CLAUDE.md.
  • Use Case: Ideal for kicking off a new product or aligning an existing codebase with a shared design system before ongoing AI-assisted work.

Quick Start

Ask the assistant to inspect the project, collect design context, and save the result to .impeccable.md.

Frequently Asked Questions about teach-impeccable

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

FAQPage Schema
How do I save project design context for future AI sessions?▼

To save project design context, the Skill scans your codebase for README files, config, and design tokens, asks missing UX questions, and writes a structured Design Context section to `.impeccable.md` for future AI sessions.

What is UX discovery and how does it work with existing codebases?▼

UX discovery here involves scanning your repository for existing components and brand assets to infer the visual direction, then asking targeted questions about users and accessibility needs that the codebase cannot answer.

Can I use CLAUDE.md to store brand guidelines and aesthetic direction?▼

Yes, you can use CLAUDE.md to store brand guidelines. The Skill optionally mirrors the structured Design Context, including brand personality and aesthetic direction, into CLAUDE.md alongside `.impeccable.md`.

Does this approach work for aligning an existing codebase with a shared design system?▼

Yes, this approach works for design-system alignment. It captures your project's current design context and accessibility needs, establishing a durable baseline to align existing codebases before ongoing AI-assisted work.

What's the best way to conduct an accessibility review before starting implementation?▼

The best way to conduct an accessibility review is by gathering accessibility needs during project discovery. The Skill asks targeted questions about these requirements and persists them in `.impeccable.md` for ongoing reference.

Related Skills

Explore More Design & Creative Skills→
vobasevobase
59

teach-impeccable

Scan project files and write design context to CLAUDE.md.

Official
Intermediate
yahya-azeemyahya-azeem

teach-impeccable

Analyze codebase artifacts and ask targeted questions to generate persistent design guidelines.

Community
Intermediate
ibnuhalimmibnuhalimm

Architect

Gather project context and produce a detailed architecture plan.

Community
Advanced
yeshan333yeshan333
94

teach-impeccable

Explore codebases and synthesize design context into a structured markdown document.

Community
Intermediate