skillport

Name: skillport
Author: gotalab

3.3kinstalls/mo · pypi404stars30forks

How to install skillport?

gotalab/skillport

$git clone https://github.com/gotalab/skillport

Installs into the current project.

Summary

The SkillOps Toolkit for Agent Skills

Files · 1

View on GitHub

README.md

1	# ⚓ SkillPort
2
3	<div align="center">
4
5	The SkillOps Toolkit for Agent Skills
6
7	SkillOps = Validate, manage, and deliver skills at scale.
8
9	[![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://python.org)
10	[![MCP](https://img.shields.io/badge/MCP-Enabled-green)](https://modelcontextprotocol.io)
11	[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
12
13	</div>
14
15	---
16
17	## Why SkillPort?
18
19	\| When you... \| SkillPort... \|
20	\|-------------\|--------------\|
21	\| Use a coding agent without native skill support \| Serves via MCP or CLI \|
22	\| Build your own AI agent \| Provides MCP server, CLI, and Python library \|
23	\| Have 50+ skills and need the right one fast \| Search-first loading ([Tool Search Tool](https://www.anthropic.com/engineering/advanced-tool-use) pattern) \|
24	\| Check skills before deployment \| Validates against the spec in CI \|
25	\| Manage skill metadata programmatically \| Provides `meta` commands \|
26	\| Find a skill on GitHub \| Installs with `add <url>` \|
27
28	Fully compatible with the [Agent Skills specification](https://agentskills.io/specification).
29
30	---
31
32	## Features
33
34	### Validate
35
36	Check skills against the [Agent Skills specification](https://agentskills.io/specification).
37
38	```bash
39	skillport validate # Validate all skills
40	skillport validate ./skills # Validate specific directory
41	skillport validate --json # CI-friendly JSON output
42	```
43
44	Catches missing fields, naming issues, and spec violations before they cause problems.
45
46	### Manage
47
48	Full lifecycle management from any source.
49
50	```bash
51	# Add from GitHub (shorthand)
52	skillport add anthropics/skills skills
53
54	# Add from GitHub (full URL)
55	skillport add https://github.com/anthropics/skills/tree/main/skills
56
57	# Add from local path or zip
58	skillport add ./my-skills
59	skillport add skills.zip
60
61	# Update, list, remove
62	skillport update # Update all from original sources
63	skillport list # See installed skills
64	skillport remove <skill-id> # Uninstall
65	```
66
67	### Metadata
68
69	Update skill metadata without editing files manually. Useful for automation and keeping skills consistent across a team.
70
71	```bash
72	skillport meta get <skill> <key> # Get metadata value
73	skillport meta set <skill> <key> <val> # Set metadata value
74	skillport meta unset <skill> <key> # Remove metadata key
75	```
76
77	### Serve
78
79	MCP server for clients that don't natively support Agent Skills.
80
81	Inspired by Anthropic's [Tool Search Tool](https://www.anthropic.com/engineering/advanced-tool-use) pattern — search first, load on demand:
82
83	\| Tool \| Purpose \|
84	\|------\|---------\|
85	\| `search_skills(query)` \| Find skills by description (full-text search) \|
86	\| `load_skill(skill_id)` \| Get full instructions + path \|
87
88	Why search matters: With 50+ skills, loading all upfront consumes context and hurts accuracy. SkillPort loads metadata only (~100 tokens/skill), then full instructions on demand.
89
90	Works with Cursor, Copilot, Windsurf, Cline, Codex, and any MCP-compatible client.
91
92	---
93
94	## Quick Start
95
96	### Install
97
98	```bash
99	uv tool install skillport
100	# or: pip install skillport
101	```
102
103	### Add Skills
104
105	```bash
106	# Add from GitHub
107	skillport add anthropics/skills skills
108
109	# Or use a custom skills directory
110	skillport --skills-dir .claude/skills add anthropics/skills skills
111	```
112
113	### Validate
114
115	```bash
116	skillport validate
117	# ✓ All 5 skill(s) pass validation
118	```
119
120	---
121
122	## Connect to Agents
123
124	Choose how to deliver skills to your AI agents:
125
126	\| Mode \| Best for \| Setup \|
127	\|------\|----------\|-------\|
128	\| [CLI Mode](#cli-mode) \| Agents with shell access (Cursor, Windsurf, Codex, etc.) \| Per-project \|
129	\| [MCP Mode](#mcp-mode) \| MCP-compatible clients, multi-project \| One-time \|
130
131	### CLI Mode
132
133	For agents that can run shell commands. No MCP configuration required.
134
135	```bash
136	skillport init # Initialize project
137	skillport doc # Generate AGENTS.md with skill table
138	skillport show <id> # Load full instructions for a skill
139	```

People who liked this also viewed

6 picks

Type

fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!MCP ServersNov 202519M12k
lean-lsp-mcpLean Theorem Prover MCPMCP ServersJul 20261.9M454
rulesyncA Utility CLI for AI Coding AgentsMCP ServersJul 2026889k1.3k
FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.MCP ServersJul 2026443k19k
repomix📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.MCP ServersJul 2026310k27k
mcp-serverMCP server for AI-assisted development of CAP applicationsMCP ServersJul 2026295k105

skillport

3.3kinstalls/mo · pypi404stars30forks

View on GitHub

How to install skillport?

gotalab/skillport

$git clone https://github.com/gotalab/skillport

Installs into the current project.

Summary

The SkillOps Toolkit for Agent Skills

Files · 1

View on GitHub

README.md

1	# ⚓ SkillPort
2
3	<div align="center">
4
5	The SkillOps Toolkit for Agent Skills
6
7	SkillOps = Validate, manage, and deliver skills at scale.
8
9	[![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://python.org)
10	[![MCP](https://img.shields.io/badge/MCP-Enabled-green)](https://modelcontextprotocol.io)
11	[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
12
13	</div>
14
15	---
16
17	## Why SkillPort?
18
19	\| When you... \| SkillPort... \|
20	\|-------------\|--------------\|
21	\| Use a coding agent without native skill support \| Serves via MCP or CLI \|
22	\| Build your own AI agent \| Provides MCP server, CLI, and Python library \|
23	\| Have 50+ skills and need the right one fast \| Search-first loading ([Tool Search Tool](https://www.anthropic.com/engineering/advanced-tool-use) pattern) \|
24	\| Check skills before deployment \| Validates against the spec in CI \|
25	\| Manage skill metadata programmatically \| Provides `meta` commands \|
26	\| Find a skill on GitHub \| Installs with `add <url>` \|
27
28	Fully compatible with the [Agent Skills specification](https://agentskills.io/specification).
29
30	---
31
32	## Features
33
34	### Validate
35
36	Check skills against the [Agent Skills specification](https://agentskills.io/specification).
37
38	```bash
39	skillport validate # Validate all skills
40	skillport validate ./skills # Validate specific directory
41	skillport validate --json # CI-friendly JSON output
42	```
43
44	Catches missing fields, naming issues, and spec violations before they cause problems.
45
46	### Manage
47
48	Full lifecycle management from any source.
49
50	```bash
51	# Add from GitHub (shorthand)
52	skillport add anthropics/skills skills
53
54	# Add from GitHub (full URL)
55	skillport add https://github.com/anthropics/skills/tree/main/skills
56
57	# Add from local path or zip
58	skillport add ./my-skills
59	skillport add skills.zip
60
61	# Update, list, remove
62	skillport update # Update all from original sources
63	skillport list # See installed skills
64	skillport remove <skill-id> # Uninstall
65	```
66
67	### Metadata
68
69	Update skill metadata without editing files manually. Useful for automation and keeping skills consistent across a team.
70
71	```bash
72	skillport meta get <skill> <key> # Get metadata value
73	skillport meta set <skill> <key> <val> # Set metadata value
74	skillport meta unset <skill> <key> # Remove metadata key
75	```
76
77	### Serve
78
79	MCP server for clients that don't natively support Agent Skills.
80
81	Inspired by Anthropic's [Tool Search Tool](https://www.anthropic.com/engineering/advanced-tool-use) pattern — search first, load on demand:
82
83	\| Tool \| Purpose \|
84	\|------\|---------\|
85	\| `search_skills(query)` \| Find skills by description (full-text search) \|
86	\| `load_skill(skill_id)` \| Get full instructions + path \|
87
88	Why search matters: With 50+ skills, loading all upfront consumes context and hurts accuracy. SkillPort loads metadata only (~100 tokens/skill), then full instructions on demand.
89
90	Works with Cursor, Copilot, Windsurf, Cline, Codex, and any MCP-compatible client.
91
92	---
93
94	## Quick Start
95
96	### Install
97
98	```bash
99	uv tool install skillport
100	# or: pip install skillport
101	```
102
103	### Add Skills
104
105	```bash
106	# Add from GitHub
107	skillport add anthropics/skills skills
108
109	# Or use a custom skills directory
110	skillport --skills-dir .claude/skills add anthropics/skills skills
111	```
112
113	### Validate
114
115	```bash
116	skillport validate
117	# ✓ All 5 skill(s) pass validation
118	```
119
120	---
121
122	## Connect to Agents
123
124	Choose how to deliver skills to your AI agents:
125
126	\| Mode \| Best for \| Setup \|
127	\|------\|----------\|-------\|
128	\| [CLI Mode](#cli-mode) \| Agents with shell access (Cursor, Windsurf, Codex, etc.) \| Per-project \|
129	\| [MCP Mode](#mcp-mode) \| MCP-compatible clients, multi-project \| One-time \|
130
131	### CLI Mode
132
133	For agents that can run shell commands. No MCP configuration required.
134
135	```bash
136	skillport init # Initialize project
137	skillport doc # Generate AGENTS.md with skill table
138	skillport show <id> # Load full instructions for a skill
139	```

People who liked this also viewed

6 picks

Type