skills.rest
github
githubOFFICIAL
Explore all skills by this author →
WebsiteGitHub

skillz-integration

Integrates the Skillz MCP server via Docker to run SKILL.md-based skills in agentic workflows.

5.1k|530|Updated Aug 12, 2025
Search Tags:#docker#container#skillz#skill execution#GitHub actions#MCP Server#Agentic Workflows
One-click install
npx skills add https://github.com/github/gh-aw --skill skillz-integration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skillz-integration
Source: https://github.com/github/gh-aw/tree/main/.github/skills/skillz-integration
Command: npx skills add https://github.com/github/gh-aw --skill skillz-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running Claude-style skills (SKILL.md files with helper scripts) inside GitHub Agentic Workflows requires an MCP server that can discover, expose, and execute them. This Skill explains how to configure the Skillz MCP server with Docker so agents can call skills as tools.

Core Features & Use Cases

  • Docker-based MCP configuration: Add Skillz as an MCP server in workflow frontmatter using the intellectronica/skillz container with a mounted skills directory.
  • Flexible skill layouts: Supports flat Claude Code-compatible directories, nested folders, and zip-packaged skills, each containing a SKILL.md with YAML frontmatter.
  • Environment and debugging options: Pass environment variables (such as API keys from secrets) and enable verbose logging for troubleshooting.
  • Use Case: You have a folder of custom skills like summarize-docs and translate. Mount that folder into the Skillz container in your workflow so the AI agent can invoke those skills when triaging issues or processing documents.

Quick Start

Add the skillz MCP server to your workflow frontmatter with the intellectronica/skillz container, mount your skills directory at /skillz, and ask the agent to use the available skills to complete the task.

Frequently Asked Questions about skillz-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Claude skills in an MCP server with Docker?▼

Use the Skillz MCP server by adding it to your workflow frontmatter with the intellectronica/skillz container. Mount your skills directory at /skillz and pass /skillz as the argument so the server can discover and expose each SKILL.md as a tool.

What directory structure does Skillz require for skills?▼

Each skill lives in its own folder or zip archive containing a SKILL.md file with YAML frontmatter. Skillz supports nested directories and zip files, while Claude Code compatibility requires a flat structure with one skill per immediate subdirectory.

Can I package skills as zip files for Skillz?▼

Yes, Skillz accepts skills packaged as .zip archives, either with SKILL.md at the archive root or inside a single top-level directory. Note that zip-packaged skills are not compatible with Claude Code's flat layout.

How do I pass API keys to skills running in the Skillz container?▼

Add an env block to the skillz MCP server configuration in your workflow frontmatter, mapping variables like API_KEY to GitHub secrets. The container forwards these environment variables to the skills it executes.

Is the Skillz MCP server safe to run with untrusted skills?▼

Skillz is an experimental proof-of-concept and should be treated as potentially unsafe. Treat skills like untrusted code and run them only in sandboxes or containers, since bundled helper scripts execute arbitrary code.

Related Skills

Explore More Software Engineering Skills→
kaushal-waygoodkaushal-waygood

skills

Expose SKILL.md frontmatter and resources as callable MCP tools.

Community
Intermediate
Cogni-AI-OUCogni-AI-OU
3

gh-aw-new

Scaffold a new gh-aw project with compiled .lock.yml artifacts.

Official
Intermediate
maxfraiehomaxfraieho

skills

Discover SKILL.md files and expose them as callable MCP tools.

Community
Intermediate
PasinduUpendraPasinduUpendra

advanced-tool-use

Structure tool search, deferred loading, and error handling for Claude agents.

Community
Advanced