$npx -y skills add jackspace/ClaudeSkillz --skill bulk-github-skills-downloaderExpert skill for downloading and consolidating Claude Code skills from multiple GitHub repositories efficiently.
| 1 | # Bulk GitHub Skills Downloader |
| 2 | |
| 3 | Expert skill for downloading and consolidating Claude Code skills from multiple GitHub repositories efficiently. |
| 4 | |
| 5 | ## Purpose |
| 6 | Automate the process of discovering, downloading, and organizing Claude Code skills from GitHub repositories at scale. This skill handles repository cloning, skill extraction, directory flattening, and organization. |
| 7 | |
| 8 | ## When to Use |
| 9 | - Downloading skills from multiple GitHub repositories |
| 10 | - Building a comprehensive skills collection |
| 11 | - Updating existing skill collections with new repositories |
| 12 | - Performing batch downloads of skills from curated lists |
| 13 | |
| 14 | ## Capabilities |
| 15 | |
| 16 | ### 1. Repository Discovery |
| 17 | - Search GitHub for "claude skills" repositories |
| 18 | - Parse curated lists (like awesome-claude-skills) |
| 19 | - Filter by stars, activity, and relevance |
| 20 | - Identify actual skill repositories vs. meta-repositories |
| 21 | |
| 22 | ### 2. Batch Download |
| 23 | - Clone multiple repositories in parallel |
| 24 | - Handle rate limiting and authentication |
| 25 | - Resume interrupted downloads |
| 26 | - Skip already-downloaded repositories |
| 27 | |
| 28 | ### 3. Skill Extraction |
| 29 | - Locate skills in various directory structures: |
| 30 | - `/.claude/skills/` |
| 31 | - `/skills/` |
| 32 | - `/` |
| 33 | - Extract skills from nested directory structures |
| 34 | - Preserve skill metadata and structure |
| 35 | |
| 36 | ### 4. Organization |
| 37 | - Flatten nested directories to `/skills/` root |
| 38 | - Add source suffixes to prevent naming conflicts |
| 39 | - Create source attribution metadata |
| 40 | - Generate inventory documentation |
| 41 | |
| 42 | ## Usage Instructions |
| 43 | |
| 44 | ### Basic Batch Download |
| 45 | ``` |
| 46 | Use the bulk-github-skills-downloader skill to download skills from: |
| 47 | - obra/superpowers |
| 48 | - diet103/claude-code-infrastructure-showcase |
| 49 | - mrgoonie/claudekit-skills |
| 50 | |
| 51 | Organize them in /skills with source suffixes. |
| 52 | ``` |
| 53 | |
| 54 | ### Download from Awesome List |
| 55 | ``` |
| 56 | Use the bulk-github-skills-downloader skill to: |
| 57 | 1. Parse the BehiSecc/awesome-claude-skills repository |
| 58 | 2. Download all listed skill repositories |
| 59 | 3. Organize and document them |
| 60 | ``` |
| 61 | |
| 62 | ### Update Existing Collection |
| 63 | ``` |
| 64 | Use the bulk-github-skills-downloader skill to update my collection with: |
| 65 | - Any new repositories with 100+ stars |
| 66 | - Skills from the last 30 days |
| 67 | - Skip repositories I already have |
| 68 | ``` |
| 69 | |
| 70 | ## Key Features |
| 71 | |
| 72 | ### Parallel Processing |
| 73 | - Clone multiple repositories simultaneously |
| 74 | - Efficient resource utilization |
| 75 | - Configurable concurrency limits |
| 76 | |
| 77 | ### Smart Filtering |
| 78 | - Detect meta-repositories (lists, tools, converters) |
| 79 | - Identify actual skill collections |
| 80 | - Skip archived or inactive repositories |
| 81 | - Filter by license compatibility |
| 82 | |
| 83 | ### Error Handling |
| 84 | - Retry failed downloads |
| 85 | - Log errors with context |
| 86 | - Continue on partial failures |
| 87 | - Generate error reports |
| 88 | |
| 89 | ### Attribution Tracking |
| 90 | - Record source repository URLs |
| 91 | - Preserve LICENSE files |
| 92 | - Track author information |
| 93 | - Generate attribution documentation |
| 94 | |
| 95 | ## Workflow |
| 96 | |
| 97 | 1. **Discovery Phase** |
| 98 | - Search GitHub or parse curated list |
| 99 | - Filter and prioritize repositories |
| 100 | - Check for existing downloads |
| 101 | |
| 102 | 2. **Download Phase** |
| 103 | - Clone repositories to /tmp |
| 104 | - Verify skill presence |
| 105 | - Extract skill directories |
| 106 | |
| 107 | 3. **Organization Phase** |
| 108 | - Flatten directory structure |
| 109 | - Add source suffixes |
| 110 | - Move to /skills directory |
| 111 | - Preserve metadata |
| 112 | |
| 113 | 4. **Documentation Phase** |
| 114 | - Generate inventory |
| 115 | - Create attribution file |
| 116 | - Update main README |
| 117 | - Log statistics |
| 118 | |
| 119 | ## Repository Detection Logic |
| 120 | |
| 121 | ### Actual Skill Repositories |
| 122 | ✅ Contains `/.claude/skills/` or `/skills/` directories |
| 123 | ✅ Has individual skill folders with SKILL.md files |
| 124 | ✅ Primary content is skills |
| 125 | |
| 126 | ### Meta-Repositories (Skip) |
| 127 | ❌ Curated lists (awesome-* pattern) |
| 128 | ❌ Converter tools (documentation → skills) |
| 129 | ❌ Frameworks or libraries |
| 130 | ❌ Archived repositories |
| 131 | |
| 132 | ## Directory Structure After Download |
| 133 | |
| 134 | ``` |
| 135 | /skills/ |
| 136 | ├── skill-name_source/ # Individual skills with source suffix |
| 137 | │ ├── SKILL.md |
| 138 | │ └── ... |
| 139 | ├── another-skill_source/ |
| 140 | │ └── ... |
| 141 | └── ... |
| 142 | ``` |
| 143 | |
| 144 | ## Configuration Options |
| 145 | |
| 146 | ### Concurrency |
| 147 | ```yaml |
| 148 | max_parallel_clones: 5 |
| 149 | max_parallel_extractions: 10 |
| 150 | ``` |
| 151 | |
| 152 | ### Filtering |
| 153 | ```yaml |
| 154 | min_stars: 50 |
| 155 | max_age_days: 365 |
| 156 | include_archived: false |
| 157 | license_types: |
| 158 | - MIT |
| 159 | - Apache-2.0 |
| 160 | - BSD |
| 161 | ``` |
| 162 | |
| 163 | ### Organization |
| 164 | ```yaml |
| 165 | flatten_skills: true |
| 166 | add_source_suffix: true |
| 167 | preserve_metadata: true |
| 168 | cleanup_temp: true |
| 169 | ``` |
| 170 | |
| 171 | ## Output |
| 172 | |
| 173 | ### Success Message |
| 174 | ``` |
| 175 | Successfully downloaded 154 skills from 5 repositories: |
| 176 | - obra/superpowers: 21 skills |
| 177 | - diet103/claude-code-infrastructure-showcase: 5 skills |
| 178 | - lackeyjb/playwright-skill: 1 skill |
| 179 | - mrgoonie/claudekit-skills: 22 skills |
| 180 | - K-Dense-AI/claude-scientific-skills: 105 skills |
| 181 | |
| 182 | Skills organized in /skills/ |
| 183 | Documentation generated in SKILLS_COLLECTION_README.md |
| 184 | ``` |
| 185 | |
| 186 | ### Error Handling |
| 187 | - Log failed repositories |
| 188 | - Continue with successful downloads |
| 189 | - Generate error report |
| 190 | - Suggest manual intervention if needed |
| 191 | |
| 192 | ## Best Practices |
| 193 | |
| 194 | 1. **Authentication**: Use GitHub token for higher rate limits |
| 195 | 2. **Incremental Updates**: Download new repositories only |
| 196 | 3. **Verification**: Check skill structure after download |
| 197 | 4. **Attribution**: Always preserve license and author info |
| 198 | 5. **Clea |