Setting the skill. One moment.
Credited skills
Skill 52 of 54
Run and integrate Skillz MCP server with Docker for skill execution.
1 minute · 273 words · 13 sections
Skillz is an MCP server that turns Claude-style skills (SKILL.md plus optional resources) into callable tools for MCP clients. It discovers skills, exposes instructions/resources, and runs bundled helper scripts.
Repository: https://github.com/intellectronica/skillz
⚠️ Experimental proof-of-concept. Potentially unsafe. Treat skills like untrusted code and run in sandboxes/containers. Use at your own risk.
To use Skillz with GitHub Agentic Workflows, add it as an MCP server in your workflow frontmatter:
on: issues
engine: copilot
mcp-servers:
skillz:
container: "intellectronica/skillz"
args:
- "-v"
- "/path/to/skills:/skillz"
- "/skillz"
# Your workflow with skills
Use skills from the skillz server to accomplish tasks.Key points:
/path/to/skills with the actual path to your skills directory/skillz inside the container/skillz as the argument to tell skillz where to find skillsSkillz looks for skills inside the root directory you provide (defaults to ~/.skillz). Each skill lives in its own folder or zip archive that includes a SKILL.md file with YAML front matter.
skills/
├── summarize-docs/
│ ├── SKILL.md
│ ├── summarize.py
│ └── prompts/example.txt
├── translate.zip
└── web-search/
└── SKILL.mdEach skill folder must contain:
SKILL.md - Required file with YAML frontmatter describing the skillExample SKILL.md:
name: summarize-docs
description: Summarize documentation files
# Document Summarization Skill
This skill helps summarize long documentation files.
Use the provided `summarize.py` script to process documents.Skills can be packaged as .zip archives:
translate.zip
├── SKILL.md
└── helpers/
└── translate.jsOr with a top-level directory:
data-cleaner.zip
└── data-cleaner/
├── SKILL.md
└── clean.pyFor compatibility with Claude Code, use a flat directory structure where every immediate subdirectory is a single skill:
skills/
├── hello-world/
│ ├── SKILL.md
│ └── run.sh
└── summarize-text/
├── SKILL.md
└── run.pyLimitations: No nested directories, no .zip files.
Skillz supports nested directories and .zip files:
skills/
├── text-tools/
│ └── summarize-text/
│ ├── SKILL.md
│ └── run.py
└── image-processing.zipNote: This layout is NOT compatible with Claude Code.
When using Docker, you can pass environment variables to skills:
mcp-servers:
skillz:
container: "intellectronica/skillz"
args:
- "-v"
- "/path/to/skills:/skillz"
- "/skillz"
env:
API_KEY: "${{ secrets.SKILL_API_KEY }}"Enable verbose logging for debugging:
mcp-servers:
skillz:
container: "intellectronica/skillz"
args:
- "-v"
- "/path/to/skills:/skillz"
- "/skillz"
- "--verbose"Credited
This skill is installed in github/gh-aw — in use here rather than published from here — so there is no install command for it on this page.
main, last pushed 24 September 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: .claude/skills/*/SKILL.md, .github/skills/*/SKILL.md, .squad/*/skill.md, SKILL.md (repo root).h1 and no skipped levels:/github/gh-aw.md, and each skill at its own .md URL.