hic-human-interact-expert
Skill5 starsChanged 22 days agoMITView on GitHub
Use when selecting or conducting an HCI method, usability evaluation, user study, task analysis, or evidence-based interaction assessment.
In this repository47 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- agents-md-fixerSkill
- arch-docsSkill
- book-to-markdownSkill
- docset-updaterSkill
- humanizerSkill
- news-release-docsSkill
- pdf-guideSkill
- readme-docsSkill
- screenshot-docsSkill
- see-also-docsSkill
- setup-install-usage-docsSkill
- bptools-writer-expertSkill
- color-accessibility-expertSkill
- css-creative-expertSkill
- game-design-expertSkill
- geometry-expertSkill
- glass-expertSkill
- openscad-3d-printing-expertSkill
- podman-expertSkill
- postgresql-expertSkill
- pyside6-engineerSkill
- rust-code-expertSkill
- solid-js-expertSkill
- svg-creator-expertSkill
- typescript-engineerSkill
- ui-ux-engineerSkill
- vision-expertSkill
- wasm-rust-expertSkill
- webwork-writer-expertSkill
- delegate-manager-to-subagentsSkill
- gas-town-workflowSkill
- hang-checkSkill
- html-game-parallel-builderSkill
- parallel-planSkill
- stay-busySkill
- repo-rules-readerSkill
- blueprint-plan-drafterSkill
- ideonomy-plainSkill
- ideonomy-richSkill
- make-goalSkill
- modest-plan-drafterSkill
- audit-code-reviewerSkill
- old-python-code-reviewSkill
- prune-testsSkill
- unit-test-starterSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Use this skill to turn a product question into an evidence-based HCI method, task model, guideline rationale, or evaluation plan.
- Distinctive: line 22
Read references/task_selection.md when the request could use research, task analysis, guidelines, or evaluation.
- Distinctive: line 32
Read references/project_workflow.md for the project-shape path and required HCI artifacts.
- Distinctive: line 59
Run guideline-conformance checks, a task-completion walkthrough, and measured accessibility checks.
- Distinctive: line 61
Read references/testing_and_oracles.md for executable checks, measurement methods, and review artifacts.
- Distinctive: line 66
Start with the local books when present.
- Distinctive: line 69
Use references/topic_index.md as the front door when the corpus is absent, then consult current W3C WCAG and the target platform's …
- Distinctive: line 74
Write scenarios in the user's language and tie every finding to a task step.
- Distinctive: line 88
When using this skill, aim to produce:
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Human interaction expert
Overview
Use this skill to turn a product question into an evidence-based HCI method, task model, guideline rationale, or evaluation plan. Frame the user goal, context, and success evidence before selecting an interaction method. Build project-specific artifacts such as a task model, study plan, heuristic ledger, and accessibility acceptance criteria so each recommendation can guide implementation and later evaluation.
Workflow
- Classify the HCI question and select a method.
- Identify the user group, goal, setting, device, task frequency, consequence of failure, and decision the team needs to make.
- Read references/task_selection.md when the request could use research, task analysis, guidelines, or evaluation.
- Consult references/topic_index.md to connect the question to a method, evidence artifact, guideline source, and oracle.
- Detect the project shape and establish the evidence baseline.
- Existing project: inventory user journeys, research findings, support issues, analytics, interface states, accessibility checks, and prior study results.
- Greenfield project: write a concise HCI brief with users, goals, context, assumptions, risks, and success measures before interface construction.
- Read references/project_workflow.md for the project-shape path and required HCI artifacts.
- Model the user's task and mental model.
- Map triggers, goals, actions, decisions, information needs, errors, recovery, handoffs, and completion evidence for each critical task.
- Capture the user's vocabulary, expectations, and visible cues that support recognition, memory, and confidence at each decision point.
- Turn the model into testable task-completion criteria and a study scenario.
- Select the smallest method that answers the decision.
- Choose interviews or contextual inquiry for unknown context and mental models.
- Choose task analysis for workflow structure and allocation questions.
- Choose cognitive walkthrough or heuristic evaluation for expert inspection.
- Choose usability sessions for observed task completion and comprehension.
- Choose an evaluation study when a hypothesis, comparison, or measured outcome requires controlled or naturalistic evidence.
- Translate evidence into guidelines and an implementation brief.
- State the applicable cognitive, accessibility, and platform guideline with its user-facing rationale and acceptance criterion.
- Hand the implementation brief to
ui-ux-engineerfor components, layouts, CSS, interface implementation, visual craft, and state polishing. - Preserve the task model and rationale while the UI work turns them into a concrete surface.
- Validate the recommendation with runnable evidence.
- Run guideline-conformance checks, a task-completion walkthrough, and measured accessibility checks; record findings and the next iteration.
- Read references/testing_and_oracles.md for executable checks, measurement methods, and review artifacts.
Implementation defaults
- Start with the local books when present; use references/local_books.md and references/reference_survey.md to select a method backed by the available corpus.
- Use references/topic_index.md as the front door when the corpus is absent, then consult current W3C WCAG and the target platform's human-interface guidelines and run the named oracle.
- Recruit representative participants when a project can conduct a study; otherwise produce an inspection plan and clearly label its evidence scope.
- Write scenarios in the user's language and tie every finding to a task step.
- State measures before collecting evidence: completion, error, time, success, confidence, comprehension, or accessibility conformance.
Quality bar
- Ground recommendations in a user goal, task context, and stated decision.
- Choose a method that can change a product decision within the available time.
- Make each guideline traceable to an observable interaction and acceptance check.
- Separate HCI method ownership from concrete interface implementation ownership.
- Record limitations, participant coverage, and unresolved assumptions clearly.
Output expectations
When using this skill, aim to produce:
- A routed HCI question with the selected method and evidence rationale.
- A task model or study plan with users, scenarios, measures, and completion criteria.
- A guideline ledger that connects cognitive, accessibility, and platform rules to implementation acceptance criteria.
- A runnable validation plan with walkthrough, conformance, and measured
accessibility oracles, plus a clear handoff to
ui-ux-engineerwhen needed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

