← Back to list

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:
checklists/command-naming.json- Naming conventionschecklists/error-messages.json- Error qualitychecklists/interaction-patterns.json- UX consistencychecklists/nielsen-heuristics.json- 10 heuristics
Step 3: Generate Report
Combine automated analysis with checklist results for final UX report.
Standards Reference
| Standard | File | Key Checks |
|---|---|---|
| Command Naming | standards/command-naming.md | CN-001 through CN-008 |
| Error Messages | standards/error-messages.md | EM-001 through EM-008 |
| Interaction Patterns | standards/interaction-patterns.md | IP-001 through IP-010 |
| Cognitive Load | standards/cognitive-load.md | CL-001 through CL-006 |
UX Heuristics (Nielsen)
| # | Heuristic | Check ID |
|---|---|---|
| 1 | Visibility of system status | NH-001 |
| 2 | Match between system and real world | NH-002 |
| 3 | User control and freedom | NH-003 |
| 4 | Consistency and standards | NH-004 |
| 5 | Error prevention | NH-005 |
| 6 | Recognition rather than recall | NH-006 |
| 7 | Flexibility and efficiency of use | NH-007 |
| 8 | Aesthetic and minimalist design | NH-008 |
| 9 | Help users recognize and recover | NH-009 |
| 10 | Help and documentation | NH-010 |
Output
Returns JSON with:
ux_score: 0-100 (higher = better)heuristic_scores: Per-heuristic ratingsnaming_issues: Command naming problemserror_issues: Error message problemsrecommendations: 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

