web-design-guidelines · alexj11324 — Claude Code skill: overview and install
web-design-guidelines is a Claude Code skill that audits Mikka's web interface for accessibility, responsive layouts, forms, and interaction flows.
AGPL-3.0 ★ 88 updated 2026-11-17
npx skills add alexj11324/Mikka --skill web-design-guidelines -a claude-codeWhat web-design-guidelines does
The skill runs audits against an adapted Web Interface Guidelines checklist tuned for the Mikka repository. It inspects semantic controls, keyboard focus handling, state indicators, layout stability, and responsiveness down to 390px widths. External design rules remain secondary to Mikka's local Figma files and the packaged presentation of paid component packs such as BoardUI Pro, affectUI, and beUI Pro.
Execution requires project documentation files: docs/design/README.md, docs/design/rules.md, docs/design/components.md, and docs/review-checklist.md. Reports follow a strict format covering file path, line number, route, user action, evidence, severity, and fix owner. Suggested fixes must rely on existing UI components rather than new styling themes.
What it helps with
- audit UI controls for semantic accessibility and keyboard focus
- detect layout overflows and issues under 390px mobile viewport widths
- verify form input validation, error placement, and draft preservation
- generate structured audit reports mapped to exact source code lines
Example prompts for the agent
- Review the user settings page against web-design-guidelines
- Audit the checkout form for keyboard accessibility and error handling
- Check the mobile navigation layout at 390px width for overflows
How to install web-design-guidelines
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill web-design-guidelines -a claude-code2Manually: put the files in place
~/.claude/skills/web-design-guidelines/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/web-design-guidelines/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill web-design-guidelines -a codex2Manually: put the files in place
.agents/skills/web-design-guidelines/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill web-design-guidelines -a cursor2Manually: put the files in place
.cursor/skills/web-design-guidelines/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alexj11324/Mikka .claude/skills/web-design-guidelines2Manually: put the files in place
.github/skills/web-design-guidelines/SKILL.md1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill web-design-guidelines -a gemini-cli2Platform CLI
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/web-design-guidelinesManually: put the files in place
.devin/skills/web-design-guidelines/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about web-design-guidelines
How to install web-design-guidelines in Claude Code?
Run npx skills add alexj11324/Mikka --skill web-design-guidelines -a claude-code in your terminal.
What does web-design-guidelines do?
It reviews web pages against accessibility, layout, navigation, and state-handling rules defined for the Mikka project.
What files does web-design-guidelines depend on?
It relies on local project docs: docs/design/README.md, docs/design/rules.md, docs/design/components.md, and docs/review-checklist.md.
Similar skills
All skills for Frontend and UI →web-design-guidelines by other authors comes first.