Back to list
jrc1883

pop-assessment-ux

by jrc1883

AI-powered development workflow automation for Claude Code. Modular plugin suite with 23 commands, 38 skills, and 22 specialized agents for professional software development.

2🍴 0📅 Jan 24, 2026

SKILL.md


name: pop-assessment-ux description: "Evaluates PopKit user experience using concrete heuristics for command naming, error messages, and interaction patterns" triggers:

  • assess ux
  • ux review
  • usability audit version: 1.0.0

UX Assessment Skill

Purpose

Provides concrete, reproducible UX assessment for PopKit plugins using:

  • Nielsen's 10 Usability Heuristics
  • Command naming conventions checklist
  • Error message quality standards
  • AskUserQuestion usage validation

How to Use

Step 1: Run Automated UX Scan

python skills/pop-assessment-ux/scripts/analyze_commands.py packages/plugin/
python skills/pop-assessment-ux/scripts/analyze_errors.py packages/plugin/
python skills/pop-assessment-ux/scripts/calculate_ux_score.py packages/plugin/

Step 2: Apply UX Checklists

Read and apply checklists in order:

  1. checklists/command-naming.json - Naming conventions
  2. checklists/error-messages.json - Error quality
  3. checklists/interaction-patterns.json - UX consistency
  4. checklists/nielsen-heuristics.json - 10 heuristics

Step 3: Generate Report

Combine automated analysis with checklist results for final UX report.

Standards Reference

StandardFileKey Checks
Command Namingstandards/command-naming.mdCN-001 through CN-008
Error Messagesstandards/error-messages.mdEM-001 through EM-008
Interaction Patternsstandards/interaction-patterns.mdIP-001 through IP-010
Cognitive Loadstandards/cognitive-load.mdCL-001 through CL-006

UX Heuristics (Nielsen)

#HeuristicCheck ID
1Visibility of system statusNH-001
2Match between system and real worldNH-002
3User control and freedomNH-003
4Consistency and standardsNH-004
5Error preventionNH-005
6Recognition rather than recallNH-006
7Flexibility and efficiency of useNH-007
8Aesthetic and minimalist designNH-008
9Help users recognize and recoverNH-009
10Help and documentationNH-010

Output

Returns JSON with:

  • ux_score: 0-100 (higher = better)
  • heuristic_scores: Per-heuristic ratings
  • naming_issues: Command naming problems
  • error_issues: Error message problems
  • recommendations: UX improvements

Score

Total Score

75/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon