unbrowse-contribute
Use whenever Unbrowse itself misbehaves - the unbrowse CLI, SDK, stdio MCP proxy or an agent plugin crashes, prints "looks like an Unbrowse bug", exits with the wrong code, ignores a documented flag, or its docs and skill describe something that does not happen; or the hosted service answers 5xx or…
Install / Use
npx skills add unbrowse-ai/unbrowse --skill unbrowse-contributeInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of unbrowse-contribute
unbrowse-contribute scores 88/100 on our quality scale, 549th of 1,153 Content & Media skills we index (top 48%).
Its SKILL.md is 4.9 KB long, well organised into 8 sections with 4 code examples: a solid amount of guidance for an agent.
It has 912 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated 13 days ago, so unbrowse-contribute is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unbrowse-contribute compared with similar skills
All 4 of these similar skills score higher than unbrowse-contribute; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unbrowse-contribute (this skill)by unbrowse-ai | 88 | 912 | 13d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install unbrowse-contribute?
- Run
npx skills add unbrowse-ai/unbrowse --skill unbrowse-contribute. The install tabs above show the steps for each supported agent. - Which AI agents does unbrowse-contribute work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unbrowse-contribute safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is unbrowse-contribute still maintained?
- The repository was last updated 13 days ago, so unbrowse-contribute is actively maintained.
Skill content
View source on GitHubname: unbrowse-contribute description: Use whenever Unbrowse itself misbehaves - the unbrowse CLI, SDK, stdio MCP proxy or an agent plugin crashes, prints "looks like an Unbrowse bug", exits with the wrong code, ignores a documented flag, or its docs and skill describe something that does not happen; or the hosted service answers 5xx or returns a wrong or empty result for a site it lists. Reproduces it, checks for an existing issue or PR, and opens a fix PR to github.com/unbrowse-ai/unbrowse (or an issue for the hosted side), with the person's OK. Also use for "report this to Unbrowse", "file a bug", "send the fix upstream".
Fix Unbrowse when it breaks
Unbrowse's client is open source. When it breaks in your hands, you hold the best bug report anyone
will ever write: the exact command, the exact output and the code one gh away. Turn it into a fix
the maintainers can merge, then carry on with the person's task.
1. Is it Unbrowse's fault?
Not bugs (follow the unbrowse skill instead):
- Exit
2input required,3sign-in or site login needed,4not verified. no_capability, a quota or credit error,model_unavailableon an index job.- The site's own 4xx, a CAPTCHA, or an input you got wrong.
Bugs:
- The CLI prints "This looks like a bug in Unbrowse", a stack trace or a
TypeError. - An HTTP 5xx from
https://unbrowse.ai, repeatable after one retry. - A documented command, flag, exit code or output field that does not behave as the docs say
(
unbrowse help,docs/cli.md, theunbrowseskill). - A plugin hook that blocks a call it should allow, or lets through one it should redirect.
- A verified result that is wrong for a site Unbrowse lists (
unbrowse site <host>).
2. Write the report
unbrowse bug "expected X, got Y" # markdown: version, OS, Node, the last failure (secrets masked)
unbrowse bug --json "expected X, got Y" # the same as JSON
The CLI keeps its last unexpected failure, redacted, in its config folder; unbrowse bug reads it.
Add the shortest command that reproduces the problem. Never paste a token, cookie, password,
customer data or a captured page body; replace them with <redacted>.
3. Check it is new
gh issue list -R unbrowse-ai/unbrowse --state all --search "<two or three words from the error>"
gh pr list -R unbrowse-ai/unbrowse --state all --search "<same words>"
Already reported: add your reproduction as a comment only if it adds something (another version or OS, a shorter repro). Do not open a duplicate.
4. Ask once
Opening an issue or PR publishes under the person's GitHub account, so ask before the first one in a session, in one line:
Unbrowse's CLI has a bug:
<one line>. I can reproduce it and have a fix with a test. Open a PR to unbrowse-ai/unbrowse from your GitHub account?
Skip the question only when the person already said yes in this session, or UNBROWSE_AUTO_PR=1 is
set. If they say no, or gh auth status fails, hand them the report and
https://github.com/unbrowse-ai/unbrowse/issues/new, then carry on.
5. Client bug: open a fix PR
The CLI, SDK, MCP proxy, plugins and docs live in the public repo. Work in a temporary folder, never inside the person's project:
cd "$(mktemp -d)"
gh repo fork unbrowse-ai/unbrowse --clone -- --depth 50
cd unbrowse && git switch -c fix/<short-name>
bun install
-
Read
AGENTS.md, then the nearestMODULE.md. -
Write the failing test first, next to the code:
packages/cli/tests/,packages/sdk/tests/, ortests/plugins.test.tsfor hooks and plugins. Run it and watch it fail. -
Fix the cause, not the symptom. Keep the change to the one bug.
-
Prove it. All of these must pass, and the PR quotes the markers:
bun test ./packages ./tests bun run typecheck bun run check:plugins # PLUGIN_SKILLS_OK bun run check:public # PUBLIC_SURFACE_OK -
Commit with a Conventional Commit (
fix(cli): …,fix(plugins): …,docs: …), push to the fork and open the PR:gh pr create -R unbrowse-ai/unbrowse --title "fix(cli): <what now works>" --body-file pr.mdpr.mdfollows.github/pull_request_template.md: the person's problem, the repro command and its output before the fix, the cause, the change, the new test and the markers above.
Do not edit upstream-owned files (skill/SKILL.md, skill/references/tools.json,
packages/sdk/src/mcp-install.ts, docs/public-surface.json): check:public rejects it. A bug
there is an issue, not a PR.
6. Hosted bug: open an issue
The server is not in this repo. Open an issue with the report, the runId or index jobId, the
time (UTC) and the shortest repro:
gh issue create -R unbrowse-ai/unbrowse --title "hosted: <what failed>" --body-file report.md
7. Then
Tell the person in one line, with the link. Go back to their task: use the workaround you found, or say plainly what is blocked. One bug per issue or PR. Never more than one PR per bug.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
