chore: import upstream snapshot with attribution

tests/ci/test_browser_use_skill_install_docs.py

@@ -0,0 +1,119 @@
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+BROWSER_USE_REPO_SKILL_URL = 'https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md'
+EXPECTED_SKILL_INSTALL_PATHS = (
+	Path('.agents') / 'skills' / 'browser-use' / 'SKILL.md',
+	Path('.claude') / 'skills' / 'browser-use' / 'SKILL.md',
+	Path('.codex') / 'skills' / 'browser-use' / 'SKILL.md',
+	Path('.copilot') / 'skills' / 'browser-use' / 'SKILL.md',
+	Path('.cursor') / 'skills' / 'browser-use' / 'SKILL.md',
+	Path('.gemini') / 'skills' / 'browser-use' / 'SKILL.md',
+	Path('.config') / 'opencode' / 'skills' / 'browser-use' / 'SKILL.md',
+)
+
+
+def _fake_browser_harness_tools(tmp_path: Path, skill_text: str) -> Path:
+	bin_dir = tmp_path / 'bin'
+	bin_dir.mkdir()
+
+	uv = bin_dir / 'uv'
+	uv.write_text(
+		'#!/usr/bin/env python3\n'
+		'import os, pathlib, sys\n'
+		'pathlib.Path(os.environ["UV_TOOL_INSTALL_ARGS_FILE"]).write_text(" ".join(sys.argv[1:]), encoding="utf-8")\n',
+		encoding='utf-8',
+	)
+	uv.chmod(0o755)
+
+	browser_harness = bin_dir / 'browser-harness'
+	browser_harness.write_text(
+		'#!/usr/bin/env python3\n'
+		'import sys\n'
+		f'text = {skill_text!r}\n'
+		'if sys.argv[1:] == ["skill"]:\n'
+		'    print(text, end="")\n'
+		'else:\n'
+		'    print("usage: browser-harness skill", file=sys.stderr)\n'
+		'    sys.exit(2)\n',
+		encoding='utf-8',
+	)
+	browser_harness.chmod(0o755)
+	return bin_dir
+
+
+def test_docs_install_browser_use_skill_from_package_alias():
+	readme = (ROOT / 'README.md').read_text(encoding='utf-8')
+
+	assert 'run `browser-use skill install` to register the skill' in readme
+	assert 'mkdir -p ~/.claude/skills/browser-use' not in readme
+	assert 'uv run --with "browser-use[browser-harness]" python -c' not in readme
+	assert 'from browser_use.skills import browser_use_skill_text' not in readme
+	assert BROWSER_USE_REPO_SKILL_URL not in readme
+	assert 'raw.githubusercontent.com/browser-use/browser-harness/main/SKILL.md' not in readme
+
+
+def test_browser_use_cli_installs_browser_harness_package_skill(tmp_path):
+	bin_dir = _fake_browser_harness_tools(tmp_path, '---\nname: browser-harness\n---\n\n# Browser Harness\n')
+
+	home = tmp_path / 'home'
+	for stale in (home / path for path in EXPECTED_SKILL_INSTALL_PATHS):
+		stale.parent.mkdir(parents=True)
+		stale.write_text('stale browser-use skill', encoding='utf-8')
+
+	uv_args = tmp_path / 'uv-args.txt'
+	env = os.environ.copy()
+	env['HOME'] = str(home)
+	env['PATH'] = os.pathsep.join(part for part in (str(bin_dir), env.get('PATH', '')) if part)
+	env['PYTHONPATH'] = os.pathsep.join(part for part in (str(ROOT), env.get('PYTHONPATH', '')) if part)
+	env['UV_TOOL_INSTALL_ARGS_FILE'] = str(uv_args)
+
+	result = subprocess.run(
+		[sys.executable, '-m', 'browser_use.cli', 'skill', 'install'],
+		cwd=ROOT,
+		env=env,
+		capture_output=True,
+		text=True,
+		timeout=10,
+	)
+
+	assert result.returncode == 0, result.stderr
+	assert uv_args.read_text(encoding='utf-8') == 'tool install --python 3.12 --upgrade --force browser-use'
+	expected = (
+		'---\n'
+		'name: browser-use\n'
+		'description: "Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work."\n'
+		'---\n\n'
+		'# Browser Use\n'
+	)
+	for installed in (home / path for path in EXPECTED_SKILL_INSTALL_PATHS):
+		assert installed.read_text(encoding='utf-8') == expected
+
+
+def test_browser_use_cli_validates_destination_before_installing_harness(tmp_path):
+	bin_dir = _fake_browser_harness_tools(tmp_path, '---\nname: browser-harness\n---\n\n# Browser Harness\n')
+	blocking_file = tmp_path / 'not-a-directory'
+	blocking_file.write_text('blocks skill directory creation', encoding='utf-8')
+
+	uv_args = tmp_path / 'uv-args.txt'
+	env = os.environ.copy()
+	env['HOME'] = str(tmp_path / 'home')
+	env['PATH'] = os.pathsep.join(part for part in (str(bin_dir), env.get('PATH', '')) if part)
+	env['PYTHONPATH'] = os.pathsep.join(part for part in (str(ROOT), env.get('PYTHONPATH', '')) if part)
+	env['UV_TOOL_INSTALL_ARGS_FILE'] = str(uv_args)
+
+	result = subprocess.run(
+		[sys.executable, '-m', 'browser_use.cli', 'skill', 'install', '--path', str(blocking_file / 'nested')],
+		cwd=ROOT,
+		env=env,
+		capture_output=True,
+		text=True,
+		timeout=10,
+	)
+
+	assert result.returncode == 1
+	assert 'is not a directory' in result.stderr
+	assert not uv_args.exists()