agent-instructions
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what does not, structure, and…
Use when planning, running, or synthesizing user research. Covers interview questions that produce evidence rather than opinions, usability testing, and turning transcripts into findings.
$ npx -y skills add nimadorostkar/Claude-Skills-collection --skill user-research --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/user-researchContext preview
The summary Claude sees to decide when to auto-load this skill.
Use when planning, running, or synthesizing user research. Covers interview questions that produce evidence rather than opinions, usability testing, and turning transcripts into findings.
name: user-research description: Use when planning, running, or synthesizing user research. Covers interview questions that produce evidence rather than opinions, usability testing, and turning transcripts into findings. metadata: category: business version: 1.0.0 tags: [research, interviews, usability, synthesis, discovery]
Learn what users actually do, as opposed to what they say they would do. The distinction is everything: people are unreliable narrators of their own future behavior and reliable narrators of their own past.
1. **Ask what decision this informs** — Research with no decision attached is a hobby. The decision determines who you talk to and what you ask. 2. **Ask about the past, not the future** — "Tell me about the last time you needed to do X" produces evidence. "Would you use a feature that does X?" produces politeness. Nobody can predict their own behavior, and everybody says yes. 3. **Ask for the story, then dig** — What happened, what did you do, what happened next, what did you do instead when it did not work. The workaround is the finding. 4. **In usability tests, give a task and shut up** — "Buy a red one, size medium." Then do not speak. Every hint you give destroys the data you came for. 5. **Synthesize across participants, not within** — One person's complaint is an anecdote. The same behavior in five of eight participants is a finding. 6. **Report behavior, and separate it from opinion** — "Six of eight participants abandoned at the address form" is evidence. "Participants said the form was confusing" is a report of what they said.
**Questions that produce evidence, and questions that do not:**
DO NOT ASK ASK INSTEAD
"Would you use a feature that "Tell me about the last time you
automatically categorizes expenses?" had to categorize expenses. Walk me
through exactly what you did."
-> Everyone says yes. It costs them
nothing to say yes. -> Produces: what they actually do,
how long it takes, what they
have already tried, and whether
it hurts enough to change.
"How often do you use the reports?" "When did you last open a report?
What were you trying to find out?"
-> Produces a made-up number, biased
upward. -> Produces a date and a real
motivation, or "I never have",
which is the finding.
"Is the interface easy to use?" [Give them a task. Say nothing.]
-> Produces politeness. -> Produces the truth in 90 seconds.
"What features do you want?" "What's the most frustrating part of
your week, in this area?"
-> Produces a wish list of features
from other products. -> Produces the problem, which is
yours to solve, rather than
their guess at a solution.**Synthesis that separates behavior from opinion:**
## Study: expense categorization — 8 participants ### Observed behavior (this is the evidence) - 6 of 8 maintain a spreadsheet ALONGSIDE the product, to do categorization the product already claims to do. Five had built it themselves; one inherited it. - Average time spent on the spreadsheet: 40 minutes per week, self-reported, and two participants showed us the file with a modification history that supports the estimate. - 7 of 8 could not find the existing bulk-categorization feature when given the task. It is two levels deep in a settings menu. - 3 of 8 said, unprompted, that they did not know the feature existed. ### What they said (this is context, not evidence) - All 8 said categorization was "important". This tells us nothing; nobody says their own workflow is unimportant. - 5 said they would "definitely use" an automatic
A curated library of 137 production-grade skills for Claude and other AI coding agents. Every skill follows one structure, speaks with one voice, and earns its place by changing what the agent does.
Repo: nimadorostkar/Claude-Skills-collection
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what does not, structure, and…
Use when an agent needs state that survives a session or a context compaction. Covers what to persist, file-based memory, structuring notes for retrieval, and…
Use when automating agent behavior with lifecycle hooks. Covers hook events, deterministic enforcement of rules the model should not be trusted to remember,…
Use when packaging skills, commands, hooks, and MCP servers into a distributable plugin. Covers manifest structure, bundling, versioning, testing, and…
Use when writing a new skill for an AI agent. Covers scoping, description writing for reliable triggering, progressive disclosure, and the difference between a…
Use when reviewing or improving an existing agent skill. Covers triggering accuracy, content quality, redundancy with the base model, and measuring whether the…