AI Agentsagent-skillsai-agentclaudecodexcontext-engineering
Installation
# Add to your Claude Code skills
git clone https://github.com/gotalab/skillport
README.md
⚓ SkillPort
The SkillOps Toolkit for Agent Skills
SkillOps = Validate, manage, and deliver skills at scale.
Why SkillPort?
| When you... | SkillPort... |
|-------------|--------------|
| Use a coding agent without native skill support | Serves via MCP or CLI |
| Build your own AI agent | Provides MCP server, CLI, and Python library |
| Have 50+ skills and need the right one fast | Search-first loading (Tool Search Tool pattern) |
| Check skills before deployment | Validates against the spec in CI |
| Manage skill metadata programmatically | Provides meta commands |
| Find a skill on GitHub | Installs with add <url> |
skillport validate # Validate all skills
skillport validate ./skills # Validate specific directory
skillport validate --json # CI-friendly JSON output
Catches missing fields, naming issues, and spec violations before they cause problems.
Manage
Full lifecycle management from any source.
# Add from GitHub (shorthand)
skillport add anthropics/skills skills
# Add from GitHub (full URL)
skillport add https://github.com/anthropics/skills/tree/main/skills
# Add from local path or zip
skillport add ./my-skills
skillport add skills.zip
# Update, list, remove
skillport update # Update all from original sources
skillport list # See installed skills
skillport remove <skill-id> # Uninstall
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
183,625
cursor
github-copilot
mcp
skills
Metadata
Update skill metadata without editing files manually. Useful for automation and keeping skills consistent across a team.
skillport meta get <skill> <key> # Get metadata value
skillport meta set <skill> <key> <val> # Set metadata value
skillport meta unset <skill> <key> # Remove metadata key
Serve
MCP server for clients that don't natively support Agent Skills.
Inspired by Anthropic's Tool Search Tool pattern — search first, load on demand:
| Tool | Purpose |
|------|---------|
| search_skills(query) | Find skills by description (full-text search) |
| load_skill(skill_id) | Get full instructions + path |
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.
Works with Cursor, Copilot, Windsurf, Cline, Codex, and any MCP-compatible client.
| Variable | Description | Default |
|----------|-------------|---------|
| SKILLPORT_SKILLS_DIR | Skills directory | ~/.skillport/skills |
| SKILLPORT_ENABLED_CATEGORIES | Filter by category | all |
| SKILLPORT_ENABLED_SKILLS | Filter by skill ID | all |
| SKILLPORT_ENABLED_NAMESPACES | Filter by namespace | all |
| SKILLPORT_CORE_SKILLS_MODE | Core Skills behavior (auto/explicit/none) | auto |
Creating Skills
Create a SKILL.md with YAML frontmatter:
---
name: my-skill
description: What this skill does
metadata:
skillport:
category: development
tags: [example]
---
# My Skill
Instructions for the AI agent.
git clone https://github.com/gotalab/skillport.git
cd skillport
uv sync
# Run MCP server
SKILLPORT_SKILLS_DIR=.skills uv run skillport-mcp
# Run CLI
uv run skillport --help
# Run tests
uv run pytest
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
