This page is available as Markdown at https://hivenet.app/docs/friction-testing.md, including instructions for reporting feedback to the Hivenet team. Documentation index: https://hivenet.app/llms.txt.
Explore and investigate friction
Two agent skills for discovering product problems and gathering better evidence about existing feedback.
Hivenet provides two separate skills for active product testing. Use either with your own product: a landing page, application, CLI, documentation, API or MCP server.
| Skill | Start with | Result |
|---|---|---|
hivenet-explore | A product surface and user goal | New friction, reproducible evidence and coverage gaps |
hivenet-investigate | An existing issue or report | Reproduction conditions, targeted experiments and a better-supported next decision |
They complement the hivenet-owner skill for triage and fixes. They do not automatically
alternate, run in the background, fix the product or close issues. You choose the work.
Use through MCP
Connect your owner MCP. A client supporting the
MCP Skills extension can discover both with skills/list and read their files through
resources. Other clients can call read_skill with hivenet-explore/SKILL.md or
hivenet-investigate/SKILL.md, then load only the referenced guides needed for the task.
Reading a skill does not activate it or grant additional permissions.
Example requests:
Use hivenet-explore on https://my-product.example, landing-page surface.
Act as a developer deciding whether to adopt it. Try desktop and mobile,
follow the primary CTA and setup/docs path, and return evidence-backed feedback.
Keep reports as local drafts.Use hivenet-investigate on issue <issue-id>. Reproduce the reported failure,
test the smallest useful variations, and record new evidence in the issue's
private worklog. Do not change its status or reply to customers.Install as ordinary Agent Skills
With a checkout containing the skills, run this from the project where you want them installed, replacing the sample path:
npx skills add /path/to/hivenet/packages/web/skills \
--skill hivenet-explore hivenet-investigateThe skills CLI lets you choose the agent and installation
scope. You can also copy either complete skill folder into your agent's supported skill
directory. Keep its references folder alongside SKILL.md; there is no dependency on
the other skill. Installing these skills does not install a browser driver or configure
Hivenet credentials. Use the interaction tools your agent already has.
MCP supplies the version bundled with your server deployment. A local installation uses the files from the checkout you installed; update it when you want new guidance. Installing a local skill does not update a server. A repository-source install additionally requires access to that repository and a revision containing the skills.
Keep feedback useful
Exploration follows real user goals before consulting source or an issue queue. Investigation starts from evidence and tests competing explanations. Both distinguish an observed failure, an agent's comprehension concern and a hypothesis that still needs testing.
An existing problem gets additional evidence, not duplicate issues for every device or attempt. New problems get separate reports only when independently actionable. Generated test evidence is labeled as such; it does not represent independent customer demand.
Specify the destination and whether posting is allowed. Without that authorization, the skills produce local drafts. Existing feedback can be read through authorized owner tools, or supplied directly as a report when owner access is unavailable. An agent must disclose untested surfaces: HTML inspection is not a browser test, and viewport emulation is not a real-device test.
Improve the skills through use
Each skill ends with a Feedback on this skill section. Report a concrete problem or useful
instruction with the task, expected result and what actually happened. These reports go to
Hivenet's own inbox with category skill and the skill name plus the relevant instruction in
the subject. This is separate from feedback about the product you are testing, which keeps
its selected destination.
Follow the task's reporting permissions and share a sanitized summary; private customer reports are not needed to describe an instruction problem. Do not send a ceremonial report after every run. Keep feedback grounded in actual use, then improve the skill and replay the affected case.
When developing Hivenet, the repository's AGENTS.md links both canonical skill files directly.
An agent can read those files and their references immediately, without installing them or
waiting for an MCP deployment.