# Polish Your Interface Designs

Many interfaces work correctly but still feel inconsistent, heavy, or distracting. This skill gives practical design engineering guidance for typography, surfaces, icons, motion, and performance.

## Install

```bash
npx skillstore add jakubkrehel/make-interfaces-feel-better
```

## Metadata

- Status: approved
- Slug: jakubkrehel-make-interfaces-feel-better
- Skillstore revision: r2
- Version status: missing
- Tree hash: 1c164b99eb8f67f5eb78bf1a44e9cdc9ec41af3d241f896dd898fd2bc578256b
- Author: jakubkrehel
- GitHub username: jakubkrehel
- License: MIT
- Repository: https://github.com/jakubkrehel/make-interfaces-feel-better/tree/main/skills/make-interfaces-feel-better/
- Ref: 1c2ebded2116f8124f45dba86a2e567f56e64d8e
- 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: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/jakubkrehel-make-interfaces-feel-better
- Manifest: https://skillstore.pages.dev/api/skills/jakubkrehel-make-interfaces-feel-better/manifest

## Capabilities

- Review interface details across typography, surfaces, animations, icons, and performance.
- Recommend specific CSS values for borders, shadows, radii, text wrapping, and numeric alignment.
- Suggest restrained entrance, exit, hover, and press interactions.
- Guide icon sizing, stroke weight, color states, and right-to-left behavior.
- Produce quick or full review reports with severity, locations, verification notes, and verdicts.

## Use Cases

- Frontend Refinement: Review a nearly finished interface and identify practical changes that improve hierarchy, consistency, responsiveness, and perceived quality.
- Design System Review: Check shared tokens and components for inconsistent radii, shadows, icon weights, typography, and interaction behavior.
- Pull Request Feedback: Turn a UI change into a focused review with severity levels, file locations, verification steps, and rejected alternatives.

## Prompt Templates

### Quick UI Check

```
Review this interface description for the most important polish issues. Focus on typography, spacing, hierarchy, contrast, and interaction feedback. Return up to five findings with severity and concrete fixes.
```

### Component Polish

```
Review the following component against polished interface practices. Check nested radii, borders, shadows, icon alignment, states, and motion. Cite the relevant component or style location and suggest exact changes.
```

### Motion And Performance

```
Audit these interface transitions and animations. Check enter and exit timing, hover frequency, reduced-motion behavior, transition properties, and will-change usage. Separate actionable findings from acceptable choices.
```

### Full Interface Audit

```
Perform a full review of this interface across typography, surfaces, animations, icons, and performance. Use quick or full review rules as requested. Include severity, locations, verification results, rejected candidates, and a final verdict.
```

## Limitations

- It provides written guidance and does not directly edit, run, or test application code.
- It cannot confirm visual results without screenshots, source files, or reported interaction states.
- Its fixed recommendations may require adjustment for an existing design system or accessibility needs.
- It does not replace user research, usability testing, or browser compatibility testing.

## Best Practices

- Inspect the highest-traffic states first, then expand to the full requested scope.
- Use exact locations, severity, observed evidence, and concrete replacement guidance.
- Verify every relevant state and label checks as not verified when evidence is unavailable.

## Anti Patterns

- Do not use transition-all when only specific properties change.
- Do not add will-change to every animated element or use it without observed stutter.
- Do not add elaborate motion to repeated interactions such as hovers, keystrokes, or tab changes.

## Security Audit

- Audited at: 2026-08-07T09:30:10.213\+00:00
- Summary: All 50 static findings are false positives. The reported keylogger, reconnaissance, and external-command matches come from benign interface guidance, CSS examples, and Markdown code spans. No prompt injection, data-exfiltration intent, network behavior, or executable commands were found.

## Stats

- Views: 19
- Downloads: 27
- Favorites: 0
- Popularity score: 0