open-skills

Name: open-skills
Author: instavm

444stars37forks

How to install open-skills?

instavm/open-skills

$git clone https://github.com/instavm/open-skills

Installs into the current project.

Summary

Anthropic recently announced Skills for Claude - reusable folders with instructions, scripts, and resources that make Claude better at specialized tasks. This tool lets you run these skills entirely on your local machine in a sandboxed

Files · 1

View on GitHub

README.md

1	<div align="center">
2
3	[![Start](https://img.shields.io/github/stars/BandarLabs/open-skills?color=yellow&style=flat&label=%E2%AD%90%20stars)](https://github.com/BandarLabs/open-skills/stargazers)
4	[![License](http://img.shields.io/:license-Apache%202.0-green.svg?style=flat)](https://github.com/BandarLabs/open-skills/blob/master/LICENSE)
5	</div>
6
7	```
8	___ ____ _____ _ _ ____ _ _____ _ _ ____
9	/ _ \\| _ \\| ____\| \ \| \| / ___\|\| \|/ /_ _\| \| \| \| / ___\|
10	\| \| \| \| \|_) \| _\| \| \\| \| \___ \\| ' / \| \|\| \| \| \| \___ \
11	\| \|_\| \| __/\| \|___\| \|\ \| ___) \| . \ \| \|\| \|___\| \|___ ___) \|
12	\___/\|_\| \|_____\|_\| \_\| \|____/\|_\|\_\___\|_____\|_____\|____/
13
14	```
15
16
17	# OpenSkills: Run Claude Skills Locally on Your Mac
18
19	Anthropic recently announced [Skills for Claude](https://www.anthropic.com/news/skills) - reusable folders with instructions, scripts, and resources that make Claude better at specialized tasks. This tool lets you run these skills entirely on your local machine in a sandboxed environment.
20
21	What this means: You can now process your files (documents, spreadsheets, presentations, images) using these specialized skills while keeping all data on your Mac. No uploads, complete privacy.
22
23	> This tool executes AI-generated code in a truly isolated sandboxed environment on your Mac using Apple's native containers.
24
25	## Demo
26
27	Watch Open-Skills in action with Gemini CLI:
28
29	![Open-Skills Demo with Gemini CLI](demo-gemini.gif)
30
31	## Why Run Skills Locally?
32
33	- Privacy: Process sensitive documents, financial data
34	- Full Control: Skills execute in an isolated container with VM-level isolation
35	- Compatibility: Works with Claude Desktop, Gemini CLI, Qwen CLI, or any MCP-compatible tool
36	- Extensibility: Import Anthropic's official skills or create your own custom skills
37
38	## Quick Start
39
40	Prerequisites: Mac with macOS and Apple Silicon (M1/M2/M3/M4/M5), Python 3.10+
41
42	```bash
43	git clone https://github.com/BandarLabs/open-skills.git
44	cd open-skills
45	chmod +x install.sh
46	./install.sh
47	```
48
49	Installation takes ~2 minutes. The MCP server will be available at `http://open-skills.local:8222/mcp`
50
51	Install required packages (use virtualenv and note the python path):
52	```bash
53	pip install -r examples/requirements.txt
54	```
55
56	## Setup: Connect Your AI Tool
57
58	This MCP server works with any MCP-compatible tool. All execution happens locally on your Mac.
59
60	### Option 1: Claude Desktop Integration
61
62	Configure Claude Desktop to use this MCP server:
63
64	1. Copy the example configuration:
65	```bash
66	cd examples
67	cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
68	```
69
70	2. Edit the configuration file and replace the placeholder paths:
71	- Replace `/path/to/your/python` with your actual Python path (e.g., `/usr/bin/python3` or `/opt/homebrew/bin/python3`)
72	- Replace `/path/to/open-skills` with the actual path to your cloned repository
73
74	Example after editing:
75	```json
76	{
77	"mcpServers": {
78	"open-skills": {
79	"command": "/opt/homebrew/bin/python3",
80	"args": ["/Users/yourname/open-skills/examples/claude_desktop/mcpproxy.py"]
81	}
82	}
83	}
84	```
85
86	3. Update Claude Desktop configuration:
87	- Open Claude Desktop
88	- Go to Settings → Developer
89	- Add the MCP server configuration
90	- Restart Claude Desktop
91
92	### Option 2: OpenCode Configuration
93
94	For OpenCode users, create `~/.config/opencode/opencode.json`:
95
96	![OpenCode Example](opencode-example.png)
97
98	```json
99	{
100	"$schema": "https://opencode.ai/config.json",
101	"mcp": {
102	"open-skills": {
103	"type": "remote",
104	"url": "http://open-skills.local:8222/mcp",
105	"enabled": true
106	}
107	}
108	}
109	```
110
111	### Option 3: Gemini CLI Configuration
112
113	Edit `~/.gemini/settings.json`:
114
115	```json
116	{
117	"theme": "Default",
118	"selectedAuthType": "oauth-personal",
119	"mcpServers": {
120	"open-skills": {
121	"httpUrl": "http://open-skills.local:8222/mcp"
122	}
123	}
124	}
125	```
126
127	For system instructions, replace `~/.gemini/GEM

People who liked this also viewed

6 picks

Type

open-skills

444stars37forks

View on GitHub

How to install open-skills?

instavm/open-skills

$git clone https://github.com/instavm/open-skills

Installs into the current project.

Summary

Files · 1

View on GitHub

README.md

1	<div align="center">
2
3	[![Start](https://img.shields.io/github/stars/BandarLabs/open-skills?color=yellow&style=flat&label=%E2%AD%90%20stars)](https://github.com/BandarLabs/open-skills/stargazers)
4	[![License](http://img.shields.io/:license-Apache%202.0-green.svg?style=flat)](https://github.com/BandarLabs/open-skills/blob/master/LICENSE)
5	</div>
6
7	```
8	___ ____ _____ _ _ ____ _ _____ _ _ ____
9	/ _ \\| _ \\| ____\| \ \| \| / ___\|\| \|/ /_ _\| \| \| \| / ___\|
10	\| \| \| \| \|_) \| _\| \| \\| \| \___ \\| ' / \| \|\| \| \| \| \___ \
11	\| \|_\| \| __/\| \|___\| \|\ \| ___) \| . \ \| \|\| \|___\| \|___ ___) \|
12	\___/\|_\| \|_____\|_\| \_\| \|____/\|_\|\_\___\|_____\|_____\|____/
13
14	```
15
16
17	# OpenSkills: Run Claude Skills Locally on Your Mac
18
19	Anthropic recently announced [Skills for Claude](https://www.anthropic.com/news/skills) - reusable folders with instructions, scripts, and resources that make Claude better at specialized tasks. This tool lets you run these skills entirely on your local machine in a sandboxed environment.
20
21	What this means: You can now process your files (documents, spreadsheets, presentations, images) using these specialized skills while keeping all data on your Mac. No uploads, complete privacy.
22
23	> This tool executes AI-generated code in a truly isolated sandboxed environment on your Mac using Apple's native containers.
24
25	## Demo
26
27	Watch Open-Skills in action with Gemini CLI:
28
29	![Open-Skills Demo with Gemini CLI](demo-gemini.gif)
30
31	## Why Run Skills Locally?
32
33	- Privacy: Process sensitive documents, financial data
34	- Full Control: Skills execute in an isolated container with VM-level isolation
35	- Compatibility: Works with Claude Desktop, Gemini CLI, Qwen CLI, or any MCP-compatible tool
36	- Extensibility: Import Anthropic's official skills or create your own custom skills
37
38	## Quick Start
39
40	Prerequisites: Mac with macOS and Apple Silicon (M1/M2/M3/M4/M5), Python 3.10+
41
42	```bash
43	git clone https://github.com/BandarLabs/open-skills.git
44	cd open-skills
45	chmod +x install.sh
46	./install.sh
47	```
48
49	Installation takes ~2 minutes. The MCP server will be available at `http://open-skills.local:8222/mcp`
50
51	Install required packages (use virtualenv and note the python path):
52	```bash
53	pip install -r examples/requirements.txt
54	```
55
56	## Setup: Connect Your AI Tool
57
58	This MCP server works with any MCP-compatible tool. All execution happens locally on your Mac.
59
60	### Option 1: Claude Desktop Integration
61
62	Configure Claude Desktop to use this MCP server:
63
64	1. Copy the example configuration:
65	```bash
66	cd examples
67	cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
68	```
69
70	2. Edit the configuration file and replace the placeholder paths:
71	- Replace `/path/to/your/python` with your actual Python path (e.g., `/usr/bin/python3` or `/opt/homebrew/bin/python3`)
72	- Replace `/path/to/open-skills` with the actual path to your cloned repository
73
74	Example after editing:
75	```json
76	{
77	"mcpServers": {
78	"open-skills": {
79	"command": "/opt/homebrew/bin/python3",
80	"args": ["/Users/yourname/open-skills/examples/claude_desktop/mcpproxy.py"]
81	}
82	}
83	}
84	```
85
86	3. Update Claude Desktop configuration:
87	- Open Claude Desktop
88	- Go to Settings → Developer
89	- Add the MCP server configuration
90	- Restart Claude Desktop
91
92	### Option 2: OpenCode Configuration
93
94	For OpenCode users, create `~/.config/opencode/opencode.json`:
95
96	![OpenCode Example](opencode-example.png)
97
98	```json
99	{
100	"$schema": "https://opencode.ai/config.json",
101	"mcp": {
102	"open-skills": {
103	"type": "remote",
104	"url": "http://open-skills.local:8222/mcp",
105	"enabled": true
106	}
107	}
108	}
109	```
110
111	### Option 3: Gemini CLI Configuration
112
113	Edit `~/.gemini/settings.json`:
114
115	```json
116	{
117	"theme": "Default",
118	"selectedAuthType": "oauth-personal",
119	"mcpServers": {
120	"open-skills": {
121	"httpUrl": "http://open-skills.local:8222/mcp"
122	}
123	}
124	}
125	```
126
127	For system instructions, replace `~/.gemini/GEM

People who liked this also viewed

6 picks

Type