# 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".

- **Type:** Skill
- **Install:** `agentstack add skill-nicepkg-ai-workflow-skill-downloader`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nicepkg](https://agentstack.voostack.com/s/nicepkg)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nicepkg](https://github.com/nicepkg)
- **Source:** https://github.com/nicepkg/ai-workflow/tree/main/.claude/skills/skill-downloader
- **Website:** https://ai-workflow.xiaominglab.com/

## Install

```sh
agentstack add skill-nicepkg-ai-workflow-skill-downloader
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
python scripts/download_from_github.py   --output 
```

**Examples:**
```bash
# 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

```bash
python scripts/download_from_archive.py  --output 
```

**Examples:**
```bash
# 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

```bash
python scripts/download_skill.py  --output 
```

Automatically detects source type:
- GitHub URL → Uses git sparse checkout
- Archive URL/path → Downloads and extracts
- Directory path → Copies directly

**Examples:**
```bash
# 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:
1. Skill folder contains `SKILL.md`
2. `SKILL.md` has valid YAML frontmatter with `name` and `description`
3. No malicious content patterns detected

## Output Structure

Downloaded skills are placed in:
```
/
└── /
    ├── 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:

```bash
# 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](https://github.com/anthropics/skills) - docx, pdf, pptx
- [gked2121/claude-skills](https://github.com/gked2121/claude-skills) - social-repurposer, canvas-design
- [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) - Collection
- [MadAppGang/claude-code](https://github.com/MadAppGang/claude-code) - SEO, content skills
- [daymade/claude-code-skills](https://github.com/daymade/claude-code-skills) - twitter-reader, fact-checker
- [skillhub.club](https://www.skillhub.club) - 1000+ skills collection

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nicepkg](https://github.com/nicepkg)
- **Source:** [nicepkg/ai-workflow](https://github.com/nicepkg/ai-workflow)
- **License:** MIT
- **Homepage:** https://ai-workflow.xiaominglab.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nicepkg-ai-workflow-skill-downloader
- Seller: https://agentstack.voostack.com/s/nicepkg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.