# Capture Project Design Context

AI design work often loses project context across sessions. This skill gathers evidence and saves reusable guidance for Claude, Codex, and Claude Code.

## Install

```bash
npx skillstore add pbakaus/teach-impeccable
```

## Metadata

- Status: approved
- Slug: pbakaus-teach-impeccable
- Skillstore revision: r1
- Version status: missing
- Tree hash: df21f53823c7bf05dadb40b70c8c42fe98704a36662e3e00d65f909f0b95a6b4
- Author: pbakaus
- GitHub username: pbakaus
- License: MIT
- Repository: https://github.com/pbakaus/impeccable/tree/main/source/skills/teach-impeccable/
- Ref: e397ce5a135369cd6def89cb6400d013e2f68f2f
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 79
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/pbakaus-teach-impeccable
- Manifest: https://skillstore.pages.dev/api/skills/pbakaus-teach-impeccable/manifest

## Capabilities

- Reviews README files, documentation, package files, configuration files, components, brand assets, tokens, and style guides.
- Asks focused UX questions only for details that cannot be inferred from the project.
- Organizes findings into users, brand personality, aesthetic direction, and design principles.
- Writes or updates a Design Context section in \`.impeccable.md\` at the project root.
- Can optionally update the configured AI guidance file after user confirmation.

## Use Cases

- Onboard a Product Team: Capture audience, brand, and interface expectations before new AI-assisted product work begins.
- Guide Frontend Implementation: Give coding agents durable design rules before they modify components, layouts, or visual styles.
- Preserve Brand Direction: Record design references, anti-references, accessibility needs, and principles for repeated project sessions.

## Prompt Templates

### Set Up Design Context

```
Use teach-impeccable to scan this project, ask only missing design questions, and create the Design Context section.
```

### Refresh Existing Context

```
Use teach-impeccable to update the existing Design Context after reviewing recent project changes and asking for missing decisions.
```

### Prepare a Redesign

```
Use teach-impeccable before a redesign. Compare the current interface, brand assets, and component patterns before writing updated guidance.
```

### Reconcile Stakeholder Direction

```
Use teach-impeccable to reconcile codebase evidence, stakeholder answers, anti-references, accessibility needs, and design principles into durable project guidance.
```

## Limitations

- Quality depends on the available project files and the user's answers.
- It does not create a complete design system or component library.
- It needs permission to write local project guidance files.
- The saved guidance should be refreshed when product or brand direction changes.

## Best Practices

- Run the skill before major UI work so design guidance is available from the start.
- Answer missing context questions with concrete users, references, constraints, and anti-references.
- Review the saved Design Context after generation and update it when direction changes.

## Anti Patterns

- Do not use the skill as a replacement for user research or design review.
- Do not leave vague answers such as modern, clean, or friendly without examples.
- Do not keep stale guidance after the product audience, brand, or accessibility needs change.

## Security Audit

- Audited at: 2026-07-06T20:47:00.553\+00:00
- Summary: The three static findings are false positives caused by inline and fenced markdown backticks in SKILL.md. I found no prompt injection attempt, data exfiltration intent, or executable command path in the reviewed file. The skill does ask the assistant to write design context to local project files, which matches its stated setup purpose.

## Stats

- Views: 145
- Downloads: 24
- Favorites: 0
- Popularity score: 0