| name | metadata-enricher |
| description | Enrich skills.json with additional metadata (category, tags, license, language, last_updated). Use when: (1) adding new metadata fields to skills.json, (2) categorizing uncatégorized skills, (3) enriching repo metadata. Triggers on: "enrich metadata", "add tags", "categorize skills", "metadata enrichment", "add categories". NOT for: updating star counts (use star-updater), or discovering new skills (use trending-crawler). |
Metadata Enricher
Enriches skills.json with additional metadata fields for better categorization and filtering.
Target Metadata Schema
{
"name": "owner/repo",
"stars": 1234,
"desc": "Description",
"url": "https://github.com/owner/repo",
"category": "code-review",
"tags": ["security", "claude"],
"license": "MIT",
"language": "Python",
"added_date": "2026-04-20",
"last_updated": "2026-04-25",
"source": "trending"
}
Workflow
1. Define Category Taxonomy
cd /Volumes/waku/github-维护/awesome/awesome-skills-repos && \
cat << 'EOF'
CATEGORIES:
- code-review
- web-development
- data-science
- devops
- mobile
- productivity
- platform-integration
- content-creation
- research
- framework
- skill-tools
- database
- security
- other
TAGS (auto-detectable):
- claude-code, cursor, opencode, codex
- python, typescript, rust, go
- mcp, api, cli, agent
- awesome, list, collection
- security, review, test
- chinese, english
EOF
2. Enrich All Repos via GitHub API
cd /Volumes/waku/github-维护/awesome/awesome-skills-repos && \
python3 << 'PYEOF'
import json
import subprocess
import time
from datetime import datetime
REPO_PATH = "/Volumes/waku/github-维护/awesome/awesome-skills-repos/skills.json"
with open(REPO_PATH, 'r') as f:
repos = json.load(f)
print(f"Total repos to enrich: {len(repos)}")
needs_enrichment = [r for r in repos if 'license' not in r or 'language' not in r]
print(f"Repos needing enrichment: {len(needs_enrichment)}")
LIMIT = 100
to_process = needs_enrichment[:LIMIT]
print(f"Processing first {LIMIT}...")
def get_metadata(name):
"""Fetch metadata from GitHub API"""
try:
result = subprocess.run(
['gh', 'api', f'/repos/{name}'],
capture_output=True, text=True, timeout=10
)
if result.returncode == 0:
data = json.loads(result.stdout)
return {
'license': (data.get('license') or {}).get('spdx_id') or 'Unknown',
'language': data.get('language') or 'Unknown',
'topics': data.get('topics', []),
'description': data.get('description') or '',
: data.get() or ,
}
except:
pass
None
CATEGORY_KEYWORDS = {
: [, , , , ],
: [, , , , ],
: [, , , , ],
: [, , , , , ],
: [, , , ],
: [, , , , ],
: [, , , , , ],
: [, , , , ],
: [, , , , ],
: [, , , , ],
: [, , , ],
: [, , , , ],
: [, , , , ],
}
def infer_category(name, desc, topics):
text = (name + + desc + + .(topics)).lower()
, keywords CATEGORY_KEYWORDS.items():
any(k text k keywords):
enriched = 0
i, repo enumerate(to_process):
name = repo.get(, )
not name:
meta = get_metadata(name)
meta:
repo[] = meta[]
repo[] = meta[]
inferred_cat = infer_category(
name,
repo.get(, ),
meta.get(, [])
)
repo[] = inferred_cat
tags = []
platform [, , , , ]:
platform name.lower() or platform repo.get(, ).lower():
tags.append(platform)
meta[] and meta[] != :
tags.append(meta[].lower())
tags.extend(meta.get(, [])[:3])
repo[] = list((tags)) tags []
enriched += 1
(i+1) % 20 == 0:
(f)
time.sleep(0.3)
with open(REPO_PATH, ) as f:
json.dump(repos, f, indent=2, ensure_ascii=False)
(f)
(f)
categories = {}
r repos:
= r.get(, )
categories[] = categories.get(, 0) + 1
()
, count sorted(categories.items(), key=lambda x: -x[1]):
(f)
PYEOF
3. Review and Validate
cd /Volumes/waku/github-维护/awesome/awesome-skills-repos && \
python3 << 'PYEOF'
import json
with open('skills.json', 'r') as f:
repos = json.load(f)
categories = {}
for r in repos:
cat = r.get('category', 'other')
if cat not in categories:
categories[cat] = []
categories[cat].append(r)
print("=== Category Samples ===\n")
for cat in sorted(categories.keys()):
print(f"## {cat} ({len(categories[cat])} repos)")
for r in categories[cat][:3]:
tags = ', '.join(r.get('tags', [])[:5])
print(f" - {r['name']} [{r.get('language','?')}] tags:{tags}")
print()
PYEOF
4. Commit
cd /Volumes/waku/github-维护/awesome/awesome-skills-repos && \
git diff --stat skills.json | head -5 && \
echo "---" && \
read -p "Commit enrichment? (y/n) " ans && \
if [ "$ans" = "y" ]; then \
git add skills.json && \
git commit -m "feat: enrich skills.json with category, tags, license, language" && \
git push; \
fi
Notes
- Run enrichment after adding many new repos
- Categories are inferred from name/description - manual review recommended for edge cases
- Tags are auto-generated from GitHub topics + inferred keywords
- Can re-run to fill in missing fields without overwriting existing data
