AI agent skill · by @modiqo

Demo Browser Research

Use for demonstrates how a prose browser skill becomes a tested SkillSpec behavior contract. Handles browser handoff and page evidence and external services. Preserves evidence with SkillSpec routes, forbids, dependencies, traces, and token-savings reports

Archived 2026-10-23 · Source updated 2026-08-09 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# browser research

Demonstrates how a prose browser skill becomes a tested SkillSpec behavior contract.

Use the directory that contains this loaded `SKILL.md` as `<skill_dir>`.
The SkillSpec contract is `<skill_dir>/skill.spec.yml`; do not assume the user's current working directory contains the spec.

Start the SkillSpec guide with the user's task:

`skillspec run-loop <skill_dir>/skill.spec.yml --input '<user task>' --trace-dir "${PWD}/.skillspec/traces" --guide agent`

Resume an existing guided run:

`skillspec run-loop <skill_dir>/skill.spec.yml --resume <run_dir> --guide agent`

Follow the printed current gate. The selected route, matched rules, forbids, allowed commands, open requirements, resume command, and end proof from the CLI guide are authoritative.

Use `skillspec query` and `skillspec refs` only for handles named by the guide. Do not read the full spec unless the guide, a blocker, or the user asks for it.

Before the final response, follow the guide's end anchor: record final-response evidence, run the printed `skillspec trace align ... --summary` command as the completion summary source, and report result, evidence, alignment summary, token usage, selected route, and run directory.

If the `skillspec` CLI is not installed, report that this skill requires SkillSpec and ask the user to install it before continuing:

```bash
curl -fsSL https://skillspec.sh/install.sh | sh
# or, with Rust installed:
cargo install skillspec
```

If the user declines or installation is impossible, read `<skill_dir>/skill.spec.yml` directly and manually follow the same route, rule, phase, dependency, forbid, proof, and completion contract. Report that CLI guidance was unavailable and alignment proof is partial.