docs: add analysis and implementation reports for VoltAgent integration
- VoltAgent repository analysis and validation reports - Similar skills analysis and implementation tracking - HTML to markdown conversion report - Final skills count verification
This commit is contained in:
sck_0
271
scripts/implement_similar_skills.py
Normal file
271
scripts/implement_similar_skills.py
Normal file
@@ -0,0 +1,271 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Implement the 12 new skills from similar skills analysis.
|
||||
9 recommended + 3 verified (evaluation, memory-systems, terraform-skill)
|
||||
"""
|
||||
|
||||
import json
|
||||
import re
|
||||
import sys
|
||||
from pathlib import Path
|
||||
from urllib.request import urlopen, Request
|
||||
from urllib.error import URLError, HTTPError
|
||||
from typing import Dict, Optional
|
||||
|
||||
def normalize_skill_name(name: str) -> str:
|
||||
"""Normalize skill name to kebab-case."""
|
||||
name = re.sub(r'[^a-z0-9-]', '-', name.lower())
|
||||
name = re.sub(r'-+', '-', name)
|
||||
return name.strip('-')
|
||||
|
||||
def download_file(url: str) -> Optional[str]:
|
||||
"""Download content from URL."""
|
||||
try:
|
||||
req = Request(url)
|
||||
req.add_header('User-Agent', 'Mozilla/5.0 (compatible; AntigravitySkillsDownloader/1.0)')
|
||||
with urlopen(req, timeout=15) as response:
|
||||
return response.read().decode('utf-8')
|
||||
except Exception as e:
|
||||
print(f" ❌ Error downloading {url}: {e}")
|
||||
return None
|
||||
|
||||
def parse_frontmatter(content: str) -> Optional[Dict]:
|
||||
"""Parse YAML frontmatter."""
|
||||
fm_match = re.search(r'^---\s*\n(.*?)\n---', content, re.DOTALL)
|
||||
if not fm_match:
|
||||
return None
|
||||
|
||||
fm_text = fm_match.group(1)
|
||||
metadata = {}
|
||||
for line in fm_text.split('\n'):
|
||||
if ':' in line:
|
||||
key, val = line.split(':', 1)
|
||||
metadata[key.strip()] = val.strip().strip('"').strip("'")
|
||||
return metadata
|
||||
|
||||
def ensure_frontmatter_compliance(content: str, skill_name: str, source_url: str, description: str) -> str:
|
||||
"""Ensure SKILL.md has compliant frontmatter."""
|
||||
metadata = parse_frontmatter(content)
|
||||
|
||||
if not metadata:
|
||||
# No frontmatter, add it
|
||||
frontmatter = f"""---
|
||||
name: {skill_name}
|
||||
description: {description}
|
||||
source: {source_url}
|
||||
risk: safe
|
||||
---
|
||||
|
||||
"""
|
||||
return frontmatter + content
|
||||
|
||||
# Update existing frontmatter
|
||||
metadata['name'] = skill_name
|
||||
metadata['description'] = description
|
||||
metadata['source'] = source_url
|
||||
if 'risk' not in metadata:
|
||||
metadata['risk'] = 'safe'
|
||||
|
||||
# Rebuild frontmatter
|
||||
frontmatter_lines = ['---']
|
||||
for key, value in metadata.items():
|
||||
if isinstance(value, str) and (' ' in value or ':' in value):
|
||||
frontmatter_lines.append(f'{key}: "{value}"')
|
||||
else:
|
||||
frontmatter_lines.append(f'{key}: {value}')
|
||||
frontmatter_lines.append('---\n')
|
||||
|
||||
# Replace frontmatter in content
|
||||
content_without_fm = re.sub(r'^---\s*\n.*?\n---\s*\n', '', content, flags=re.DOTALL)
|
||||
return '\n'.join(frontmatter_lines) + content_without_fm
|
||||
|
||||
def ensure_when_to_use_section(content: str, description: str) -> str:
|
||||
"""Ensure 'When to Use' section exists."""
|
||||
if re.search(r'##\s+When\s+to\s+Use', content, re.IGNORECASE):
|
||||
return content
|
||||
|
||||
# Add section after frontmatter
|
||||
when_to_use = f"""
|
||||
## When to Use This Skill
|
||||
|
||||
{description}
|
||||
|
||||
Use this skill when working with {description.lower()}.
|
||||
"""
|
||||
|
||||
# Insert after frontmatter
|
||||
content = re.sub(r'(---\s*\n.*?\n---\s*\n)', r'\1' + when_to_use, content, flags=re.DOTALL)
|
||||
return content
|
||||
|
||||
def main():
|
||||
base_dir = Path(__file__).parent.parent
|
||||
|
||||
# Load similar skills analysis
|
||||
analysis_file = base_dir / "similar_skills_analysis.json"
|
||||
with open(analysis_file, 'r') as f:
|
||||
analysis = json.load(f)
|
||||
|
||||
# Skills to implement: 9 recommended + 3 verified
|
||||
skills_to_implement = [
|
||||
# 9 Recommended
|
||||
{
|
||||
'name': 'frontend-slides',
|
||||
'url': 'https://github.com/zarazhangrui/frontend-slides',
|
||||
'raw_url': 'https://github.com/zarazhangrui/frontend-slides/raw/main/SKILL.md',
|
||||
'description': 'Generate animation-rich HTML presentations with visual style previews',
|
||||
'org': 'zarazhangrui',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'linear-claude-skill',
|
||||
'url': 'https://github.com/wrsmith108/linear-claude-skill',
|
||||
'raw_url': 'https://github.com/wrsmith108/linear-claude-skill/raw/main/SKILL.md',
|
||||
'description': 'Manage Linear issues, projects, and teams',
|
||||
'org': 'wrsmith108',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'skill-rails-upgrade',
|
||||
'url': 'https://github.com/robzolkos/skill-rails-upgrade',
|
||||
'raw_url': 'https://github.com/robzolkos/skill-rails-upgrade/raw/master/SKILL.md',
|
||||
'description': 'Analyze Rails apps and provide upgrade assessments',
|
||||
'org': 'robzolkos',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'context-fundamentals',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-fundamentals',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-fundamentals/SKILL.md',
|
||||
'description': 'Understand what context is, why it matters, and the anatomy of context in agent systems',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'context-degradation',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-degradation',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-degradation/SKILL.md',
|
||||
'description': 'Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'context-compression',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-compression',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-compression/SKILL.md',
|
||||
'description': 'Design and evaluate compression strategies for long-running sessions',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'context-optimization',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/context-optimization',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/context-optimization/SKILL.md',
|
||||
'description': 'Apply compaction, masking, and caching strategies',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'multi-agent-patterns',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/multi-agent-patterns',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/multi-agent-patterns/SKILL.md',
|
||||
'description': 'Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'tool-design',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/tool-design',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/tool-design/SKILL.md',
|
||||
'description': 'Build tools that agents can use effectively, including architectural reduction patterns',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
# 3 Verified (notebooklm-skill is duplicate, skip it)
|
||||
{
|
||||
'name': 'evaluation',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/evaluation',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/evaluation/SKILL.md',
|
||||
'description': 'Build evaluation frameworks for agent systems',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'memory-systems',
|
||||
'url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/memory-systems',
|
||||
'raw_url': 'https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/raw/main/skills/memory-systems/SKILL.md',
|
||||
'description': 'Design short-term, long-term, and graph-based memory architectures',
|
||||
'org': 'muratcankoylan',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
{
|
||||
'name': 'terraform-skill',
|
||||
'url': 'https://github.com/antonbabenko/terraform-skill',
|
||||
'raw_url': 'https://github.com/antonbabenko/terraform-skill/raw/master/SKILL.md',
|
||||
'description': 'Terraform infrastructure as code best practices',
|
||||
'org': 'antonbabenko',
|
||||
'category': 'Community Skills'
|
||||
},
|
||||
]
|
||||
|
||||
print(f"🚀 Implementing {len(skills_to_implement)} new skills...\n")
|
||||
|
||||
results = {
|
||||
'success': [],
|
||||
'failed': []
|
||||
}
|
||||
|
||||
for skill in skills_to_implement:
|
||||
skill_name = skill['name']
|
||||
raw_url = skill['raw_url']
|
||||
source_url = skill['url']
|
||||
description = skill['description']
|
||||
|
||||
print(f"📦 Processing: {skill_name}")
|
||||
|
||||
# Download SKILL.md
|
||||
content = download_file(raw_url)
|
||||
if not content:
|
||||
print(f" ❌ Failed to download")
|
||||
results['failed'].append(skill_name)
|
||||
continue
|
||||
|
||||
# Check if it's HTML (shouldn't be, but just in case)
|
||||
if '<!DOCTYPE html>' in content or ('<html>' in content.lower() and content.count('<html>') > 1):
|
||||
print(f" ⚠️ Received HTML instead of markdown, trying alternative URL")
|
||||
# Try alternative raw URL
|
||||
alt_url = raw_url.replace('/raw/main/', '/raw/master/') if '/raw/main/' in raw_url else raw_url.replace('/raw/master/', '/raw/main/')
|
||||
alt_content = download_file(alt_url)
|
||||
if alt_content and not ('<!DOCTYPE html>' in alt_content or '<html>' in alt_content.lower()):
|
||||
content = alt_content
|
||||
print(f" ✅ Got markdown from alternative URL")
|
||||
else:
|
||||
print(f" ❌ Still HTML, skipping")
|
||||
results['failed'].append(skill_name)
|
||||
continue
|
||||
|
||||
# Ensure compliance
|
||||
content = ensure_frontmatter_compliance(content, skill_name, source_url, description)
|
||||
content = ensure_when_to_use_section(content, description)
|
||||
|
||||
# Create skill directory
|
||||
skill_dir = base_dir / "skills" / skill_name
|
||||
skill_dir.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
# Write SKILL.md
|
||||
skill_file = skill_dir / "SKILL.md"
|
||||
skill_file.write_text(content, encoding='utf-8')
|
||||
|
||||
print(f" ✅ Created: {skill_file}")
|
||||
results['success'].append(skill_name)
|
||||
|
||||
print(f"\n✅ Implementation complete!")
|
||||
print(f" Success: {len(results['success'])}")
|
||||
print(f" Failed: {len(results['failed'])}")
|
||||
|
||||
if results['failed']:
|
||||
print(f"\n❌ Failed skills: {', '.join(results['failed'])}")
|
||||
|
||||
return results
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user