SkillSAFE
LLM-managed skills platform using MCP - create, edit, and execute skills programmatically in Claude, Cursor, and any MCP-compatible client without manual file uploads.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A Model Context Protocol (MCP) server that enables Claude to manage skills stored in ~/.skill-mcp/skills. This system allows Claude to create, edit, run, and manage skills programmatically, including execution of skill scripts with environment variables.
Quick Status
Status: ✅ Production Ready Test Coverage: 86% (145/145 tests passing) Deployed: October 18, 2025 Architecture: 22-module modular Python package with unified CRUD architecture
Overview
TL;DR: Write Python code that unifies multiple skills in one execution - follows Anthropic's MCP pattern for 98.7% more efficient agents.
This project consists of two main components:
- MCP Server (
src/skill_mcp/server.py) - A Python package providing 5 unified CRUD tools for skill management - Skills Directory (
~/.skill-mcp/skills/) - Where you store and manage your skills
Key Advantages
🚀 Unified Multi-Skill Execution (Code Execution with MCP)
Build once, compose everywhere - Execute Python code that seamlessly combines multiple skills in a single run:
# One execution, multiple skills unified!
# Imports from calculator, data-processor, and weather skills
from math_utils import calculate_average # calculator skill
from json_fetcher import fetch_json # data-processor skill
from weather_api import get_forecast # weather skill
# Fetch weather data
weather = fetch_json('https://api.weather.com/cities')
# Calculate averages using calculator utilities
temps = [city['temp'] for city in weather['cities']]
avg_temp = calculate_average(temps)
# Get detailed forecast
forecast = get_forecast('London')
print(f"Average temperature: {avg_temp}°F")
print(f"London forecast: {forecast}")What makes this powerful:
- ✅ Context-efficient - Dependencies and env vars auto-aggregated from all referenced skills
- ✅ **Composable
fa65cf7a0c22OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add skill-mcp --env API_KEY=${API_KEY} -- uvx skill-mcp{
"mcpServers": {
"skill-mcp": {
"command": "uvx",
"args": [
"skill-mcp"
],
"env": {
"API_KEY": "${API_KEY}"
}
}
}
}Exposed tools (5)
3 read · 2 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
execute_python_code | write | |
run_skill_script | write | |
skill_crud | read | |
skill_env_crud | read | |
skill_files_crud | read |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (12)
.pre-commit-config.yaml
print(f"API_KEY: {api_key}")validate_path(skill_name, "../../../etc/passwd")
await ScriptService.run_script("test-skill", "../../etc/passwd")"test-skill", "scripts/test.py", working_dir="../../etc"
6. **Run with minimal permissions** - Don't run skills as root or with elevated privileges
**skill-mcp** is a Model Context Protocol (MCP) server that enables LLMs to manage skills stored in `~/.skill-mcp/skills`. The system uses a unified CRUD architecture to provide programmatic access to
# api_client.py can access API_KEY and API_URL from its .env file
- ✅ No need to manually load .env files
- **read** - List environment variable keys for a skill (values hidden for security)
- ✅ Read/set/delete/clear environment variables
curl -LsSf https://astral.sh/uv/install.sh | sh
Gates applied: no_behavioural_pass.
fa65cf7a0c22full audit observations/trust-audit/mcp-server/fkesheh__skill.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | fa65cf7a0c22 | SAFE | B | 89 | first audit |
Questions
What is the Skill MCP server?
LLM-managed skills platform using MCP - create, edit, and execute skills programmatically in Claude, Cursor, and any MCP-compatible client without manual file uploads.
What tools does Skill expose?
5 in total: 3 read-only, 2 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Skill safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Skill need?
It reads API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Skill run?
It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as skill-mcp.
How current is this page?
The grade is for one exact copy of the source (fa65cf7a0c22), read on 2026-10-08. The repository is watched and re-audited when it changes.