barebrowse 0.3.2 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/CHANGELOG.md +6 -3
  2. package/README.md +5 -9
  3. package/docs/skill-template.md +8 -21
  4. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,10 +1,13 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.3.3
4
+
5
+ - Simplified skill install paths: Claude Code (`.claude/` project, `~/.claude/` global), other agents (`.barebrowse/commands/` project, `~/.config/barebrowse/commands/` global)
6
+
3
7
  ## 0.3.2
4
8
 
5
- - Skill install table in README: per-agent instructions for Claude Code, Cursor, Windsurf, Copilot (project + global scope)
6
- - Clarified that `npm install barebrowse` is still required — the skill file is documentation only
7
- - New: `docs/skill-template.md` — generic template for any CLI tool to create a skill file, with frontmatter reference, install locations, and skill-vs-MCP comparison
9
+ - Skill install instructions in README, clarified `npm install` still required — skill is documentation only
10
+ - New: `docs/skill-template.md` — generic template for any CLI tool to create a skill file
8
11
 
9
12
  ## 0.3.1
10
13
 
package/README.md CHANGED
@@ -45,15 +45,11 @@ Outputs go to `.barebrowse/` as files -- agents read them with their file tools,
45
45
 
46
46
  **Teach your agent the commands** by installing the skill file (a markdown reference the agent reads as context). The CLI tool itself still needs `npm install barebrowse` -- the skill just teaches the agent how to use it.
47
47
 
48
- | Agent | Project scope | Global scope |
49
- |-------|---------------|--------------|
50
- | **Claude Code** | `.claude/skills/barebrowse/SKILL.md` (auto-detected) | `barebrowse install --skill` |
51
- | **Cursor** | `.cursor/rules/barebrowse.md` | `~/.cursor/rules/barebrowse.md` |
52
- | **Windsurf** | `.windsurf/rules/barebrowse.md` | `~/.windsurf/rules/barebrowse.md` |
53
- | **Copilot** | Append to `.github/copilot-instructions.md` | N/A |
54
- | **Any agent** | Copy `SKILL.md` to project root or context dir | Varies |
55
-
56
- Source file: [.claude/skills/barebrowse/SKILL.md](.claude/skills/barebrowse/SKILL.md). For writing your own skill files: [docs/skill-template.md](docs/skill-template.md).
48
+ **Claude Code:** `.claude/skills/barebrowse/` (project) or `~/.claude/skills/barebrowse/` (global, via `barebrowse install --skill`).
49
+
50
+ **Other agents:** `.barebrowse/commands/` (project) or `~/.config/barebrowse/commands/` (global). Copy [SKILL.md](.claude/skills/barebrowse/SKILL.md) there.
51
+
52
+ For writing your own skill files for other CLI tools: [docs/skill-template.md](docs/skill-template.md).
57
53
 
58
54
  ### 2. MCP server -- for Claude Desktop, Cursor, and other MCP clients
59
55
 
package/docs/skill-template.md CHANGED
@@ -63,23 +63,11 @@ Show a real example so the agent knows what to expect.
63
63
 
64
64
  The skill file is just a `.md` file placed where the agent can find it:
65
65
 
66
- ### Claude Code
66
+ **Claude Code:** `.claude/skills/your-tool/` (project) or `~/.claude/skills/your-tool/` (global).
67
67
 
68
- | Scope | Location | How |
69
- |-------|----------|-----|
70
- | **This project only** | `.claude/skills/your-tool/SKILL.md` | Copy file into project |
71
- | **All projects (global)** | `~/.config/claude/skills/your-tool/SKILL.md` | Copy file to home config |
68
+ **Other agents:** `.your-tool/commands/` (project) or `~/.config/your-tool/commands/` (global).
72
69
 
73
- ### Other coding agents (Cursor, Windsurf, Copilot, etc.)
74
-
75
- | Agent | Project scope | Global scope |
76
- |-------|---------------|--------------|
77
- | **Cursor** | `.cursor/rules/your-tool.md` | `~/.cursor/rules/your-tool.md` |
78
- | **Windsurf** | `.windsurf/rules/your-tool.md` | `~/.windsurf/rules/your-tool.md` |
79
- | **GitHub Copilot** | `.github/copilot-instructions.md` (append) | N/A |
80
- | **Generic** | Drop in project root as `your-tool.context.md` | Varies by agent |
81
-
82
- > **Note:** Non-Claude agents ignore the YAML frontmatter — they just read it as markdown context. The `allowed-tools` field is Claude Code specific.
70
+ Non-Claude agents ignore the YAML frontmatter — they just read it as markdown context. The `allowed-tools` field is Claude Code specific.
83
71
 
84
72
  ## What the skill does NOT do
85
73
 
@@ -104,16 +92,15 @@ Both require the underlying tool to be installed. Choose based on your agent's c
104
92
 
105
93
  ## Example: barebrowse
106
94
 
107
- barebrowse ships its skill at `.claude/skills/barebrowse/SKILL.md`. Install options:
95
+ barebrowse ships its skill at `.claude/skills/barebrowse/SKILL.md`:
108
96
 
109
97
  ```bash
110
- # Project-local (Claude Code picks it up automatically)
98
+ # Claude Code — project
111
99
  cp node_modules/barebrowse/.claude/skills/barebrowse/SKILL.md .claude/skills/barebrowse/SKILL.md
112
100
 
113
- # Global (all projects)
101
+ # Claude Code — global
114
102
  barebrowse install --skill
115
- # copies to ~/.config/claude/skills/barebrowse/SKILL.md
116
103
 
117
- # For Cursor
118
- cp node_modules/barebrowse/.claude/skills/barebrowse/SKILL.md .cursor/rules/barebrowse.md
104
+ # Other agents — project or global
105
+ cp node_modules/barebrowse/.claude/skills/barebrowse/SKILL.md .barebrowse/commands/SKILL.md
119
106
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "barebrowse",
3
- "version": "0.3.2",
3
+ "version": "0.3.3",
4
4
  "description": "Authenticated web browsing for autonomous agents via CDP. URL in, pruned ARIA snapshot out.",
5
5
  "type": "module",
6
6
  "main": "src/index.js",