teach-impeccable

Scan repository metadata and brand assets to write design context to .impeccable.md.

Updated Oct 30, 2025

Search Tags:#documentation #guidelines #design-tokens #design-context #brand-assets #ai-config #ux-questions

Ready to run

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

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: teach-impeccable
Source: https://github.com/juanelojga/juanelojga-webpage/tree/main/.agents/skills/teach-impeccable
Command: npx skills add https://github.com/juanelojga/juanelojga-webpage --skill teach-impeccable-juanelojga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams capture and persist project design context for consistent AI-assisted decisions by gathering contextual information from the repository and storing it in a central design guide.

Core Features & Use Cases

Codebase discovery: scans README/docs, tech stack, components, brand assets, and design tokens to surface design context.
UX questions: stops to prompt for clarifications via AskUserQuestion to tailor guidelines.
Design context persistence: writes a dedicated .impeccable.md file at the repo root, including a Design Context section; optionally appends to CLAUDE.md if requested.
One-time setup: runs once to establish persistent guidelines for future sessions.

Quick Start

Run the teach-impeccable skill to collect design context and save it to .impeccable.md for all future AI sessions.

Frequently Asked Questions about teach-impeccable

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

FAQPage Schema

How do I capture and persist project design context for AI-assisted development?▼

To capture design context, scan repository metadata like README docs, tech stack, components, and brand assets, then write the gathered guidelines to a central .impeccable.md file at the repo root for future AI sessions.

What is the best way to maintain a single source of truth for design tokens and guidelines?▼

A single source of truth for design tokens is maintained by scanning your codebase for brand assets and docs, then persisting them into a dedicated .impeccable.md design context file to lock in consistent guidelines.

How do I create a design context file that stops to prompt for UX clarifications?▼

You can create a design context file by running a skill that scans your repository and uses AskUserQuestion to stop and prompt for UX clarifications, tailoring the guidelines before writing them to .impeccable.md.

Can I append design guidelines to CLAUDE.md when setting up project context?▼

Yes, you can optionally append the captured design guidelines and context to CLAUDE.md, alongside generating the primary .impeccable.md file, ensuring AI assistants read the persisted rules.

Does this design context discovery process require any external dependencies?▼

No, this design context discovery process requires zero external dependencies, operating entirely by scanning existing repository metadata and brand assets to establish your project guidelines.

When do I need to run the design context capture process for my codebase?▼

You need to run this design context capture process once as a setup step to establish persistent guidelines, ensuring all subsequent AI-assisted sessions automatically follow your locked-in design rules.