Ai-workflow skill-downloader

Download and install Claude Code skills from various sources. Supports GitHub repositories, compressed archives (.zip, .tar.gz, .skill), and direct URLs. Use when user wants to download, install, or add a skill from GitHub, URL, or archive file. Triggers on "download skill", "install skill", "add skill from", "get skill".

install

source · Clone the upstream repo

git clone https://github.com/nicepkg/ai-workflow

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/nicepkg/ai-workflow "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/skill-downloader" ~/.claude/skills/nicepkg-ai-workflow-skill-downloader-aa18f0 && rm -rf "$T"

manifest: .claude/skills/skill-downloader/SKILL.md

source content

Skill Downloader

Download and install Claude Code skills from multiple sources.

Supported Sources

Source Type Examples

GitHub Repository

https://github.com/user/repo

github.com/user/repo

Compressed Archive

.zip

.tar.gz

.tgz

.skill

(renamed zip)

Direct URL URL pointing to archive or skill folder

Usage

Download from GitHub

python scripts/download_from_github.py <repo-url> <skill-path> --output <target-dir>

Examples:

# Official Anthropic skills
python scripts/download_from_github.py https://github.com/anthropics/skills skills/docx --output ./.claude/skills/

# Community skills (root level)
python scripts/download_from_github.py https://github.com/gked2121/claude-skills social-repurposer --output ./.claude/skills/

# Nested skill path
python scripts/download_from_github.py https://github.com/MadAppGang/claude-code skills/content-brief --output ./.claude/skills/

Download from Archive

python scripts/download_from_archive.py <url-or-path> --output <target-dir>

Examples:

# From URL
python scripts/download_from_archive.py https://example.com/skills/my-skill.zip --output ./.claude/skills/

# From local file
python scripts/download_from_archive.py ./downloads/my-skill.tar.gz --output ./.claude/skills/

# .skill files (renamed zip)
python scripts/download_from_archive.py https://skillhub.club/download/awesome-skill.skill --output ./.claude/skills/

Unified Download Command

python scripts/download_skill.py <source> --output <target-dir>

Automatically detects source type:

GitHub URL → Uses git sparse checkout
Archive URL/path → Downloads and extracts
Directory path → Copies directly

Examples:

# Auto-detect GitHub
python scripts/download_skill.py https://github.com/anthropics/skills/tree/main/skills/docx --output ./.claude/skills/

# Auto-detect archive
python scripts/download_skill.py https://example.com/my-skill.zip --output ./.claude/skills/

Validation

All download methods validate:

Skill folder contains
```
SKILL.md
```
```
SKILL.md
```
has valid YAML frontmatter with
```
name
```
and
```
description
```
No malicious content patterns detected

Output Structure

Downloaded skills are placed in:

<output-dir>/
└── <skill-name>/
    ├── SKILL.md        # Required
    ├── scripts/        # Optional
    └── ...

Error Handling

Error	Cause	Solution
Skill already exists	Target directory exists	Use `--force` to overwrite
SKILL.md not found	Invalid skill package	Verify source contains SKILL.md
Invalid archive	Corrupted or unsupported format	Check file integrity
Network error	Download failed	Retry or check URL

Integration with Workflow Creator

When used with workflow-creator, download skills to workflow's

.claude/skills/

directory:

# Create workflow first
python /path/to/workflow-creator/scripts/create_workflow.py my-workflow --path ./workflows

# Then download skills
python scripts/download_skill.py https://github.com/anthropics/skills/tree/main/skills/docx --output ./workflows/my-workflow/.claude/skills/

Skill Sources Reference

Popular skill repositories:

Anthropic Official - docx, pdf, pptx
gked2121/claude-skills - social-repurposer, canvas-design
ComposioHQ/awesome-claude-skills - Collection
MadAppGang/claude-code - SEO, content skills
daymade/claude-code-skills - twitter-reader, fact-checker
skillhub.club - 1000+ skills collection