claude-red is a curated library of offensive security skills designed for the Claude skills system. Each skill is a structured SKILL.md file that primes Claude with expert-level methodology for a specific attack surface — from SQLi to shellcode, EDR evasion to exploit development.
feat: add bulk skill converter for Claude Console compatibility
dEEpEst1672ebd2ddbd
diff --git a/convert_skills.py b/convert_skills.pynew file mode 100644index 0000000..57e83d6--- /dev/null+++ b/convert_skills.py@@ -0,0 +1,215 @@+#!/usr/bin/env python3+"""+Claude Skills Converter v4+Parser específico para formato Markdown con ## headers y - **Field**: value+name = folder value (no skill name)+"""+import re+import zipfile+from pathlib import Path++INPUT_DIR = Path("skills")+OUTPUT_DIR = Path("skills-converted")+ZIP_DIR = Path("skills-zip")++def parse_skill(content: str, file_path: Path) -> dict:+ # Normalizar saltos de línea+ content = content.replace('\r\n', '\n').replace('\r', '\n')+ lines = content.split('\n')++ meta = {+ 'name': None, # Será igual a folder+ 'folder': None,+ 'source': None,+ 'description': [],+ 'triggers': [],+ 'body': []+ }++ state = 'INIT'++ for line in lines:+ stripped = line.strip()+ if not stripped:+ if state in ('DESCRIPTION', 'BODY'):+ # Preservar saltos de línea en descripción y cuerpo+ if state == 'DESCRIPTION' and meta['description']:+ meta['description'].append('')+ elif state == 'BODY':+ meta['body'].append('')+ continue++ # Detectar headers Markdown (## Section)+ header_match = re.match(r'^##\s+(.+)', stripped, re.I)+ if header_match:+ section = header_match.group(1).strip().lower()+ if section == 'metadata':+ state = 'METADATA'+ elif section == 'description':+ state = 'DESCRIPTION'+ elif section == 'trigger phrases':+ state = 'TRIGGER'+ elif section == 'instructions for claude':+ state = 'BODY'+ meta['body'].append('# Instructions for Claude')+ elif section == 'full methodology':+ state = 'BODY'+ meta['body'].append('## Full Methodology')+ continue++ # Procesar según estado+ if state == 'METADATA' and stripped.startswith('- **'):+ # Formato: - **Field Name**: value+ match = re.match(r'-\s*\*\*([^*]+)\*\*\s*:\s*(.+)', stripped)+ if match:+ key = match.group(1).strip().lower().replace(' ', '_')+ val = match.group(2).strip()+ if key == 'skill_name':+ pass # No usamos este para name+ elif key == 'folder':+ meta['folder'] = val+ # name = folder (según requerimiento)+ meta['name'] = re.sub(r'[^a-z0-9]+', '-', val.lower()).strip('-')+ elif key == 'source':+ meta['source'] = val++ elif state == 'DESCRIPTION':+ # Ignorar líneas que sean headers o metadata+ if not stripped.startswith('##') and not stripped.startswith('- **'):+ meta['description'].append(stripped)++ elif state == 'TRIGGER':+ # Buscar bloque entre backticks: `a, b, c`+ match = re.search(r'`([^`]+)`', stripped)+ if match:+ raw = match.group(1)+ meta['triggers'] = [t.strip() for t in raw.split(',') if t.strip()]++ elif state == 'BODY':+ # Preservar todo el contenido restante+ if not stripped.startswith('##') or stripped.startswith('###'):+ meta['body'].append(line.rstrip())++ # Finalizar campos+ meta['description'] = ' '.join(d for d in meta['description'] if d.strip())+ if not meta['description']:+ meta['description'] = 'Sin descripción disponible.'++ meta['body'] = '\n'.join(meta['body']) if meta['body'] else '# Instructions for Claude\n[Contenido no parseado]'++ # Fallback: si no hay folder, usar nombre de carpeta del archivo+ if not meta['name']:+ parent = file_path.parent.name+ meta['name'] = re.sub(r'[^a-z0-9]+', '-', parent.lower()).strip('-') if parent != 'skills' else file_path.stem++ return meta++def build_yaml(meta: dict) -> str:+ lines = ['---', f'name: {meta["name"]}', 'description: >']+ words = meta['description'].split()+ line = ' '+ for w in words:+ if len(line) + len(w) + 1 > 80:+ lines.append(line)+ line = ' ' + w+ else:+ line += (' ' if len(line) > 2 else '') + w+ if line.strip():+ lines.append(line)++ lines.append('trigger_phrases:')+ for t in meta['triggers']:+ lines.append(f' - "{t}"')+ if meta.get('folder'):+ lines.append(f'folder: {meta["folder"]}')+ if meta.get('source'):+ lines.append(f'source: {meta["source"]}')+ lines.append('---')+ return '\n'.join(lines)++def process_file(in_path: Path, out_dir: Path, debug: bool = False) -> bool:+ try:+ for enc in ['utf-8', 'utf-8-sig', 'latin-1']:+ try:+ text = in_path.read_text(encoding=enc)+ break+ except UnicodeDecodeError:+ continue+ else:+ return False++ meta = parse_skill(text, in_path)++ if debug:+ print(f"\n🔍 DEBUG {in_path.name}")+ print(f" Name: {meta['name']}")+ print(f" Folder: {meta['folder']}")+ print(f" Desc: {meta['description'][:120]}...")+ print(f" Trig: {meta['triggers'][:3]}... ({len(meta['triggers'])} total)")+ print(f" Src: {meta['source']}")+ print(f" Body preview: {meta['body'][:100]}...")+ return True++ yaml_block = build_yaml(meta)+ final = f"{yaml_block}\n\n{meta['body']}\n"++ out = out_dir / meta['name']+ out.mkdir(parents=True, exist_ok=True)+ (out / 'SKILL.md').write_text(final, encoding='utf-8', newline='\n')+ print(f"✅ {in_path.parent.name:35} → {meta['name']}/SKILL.md (Triggers: {len(meta['triggers'])})")+ return True+ except Exception as e:+ print(f"❌ {in_path.name}: {e}")+ import traceback+ traceback.print_exc()+ return False++def create_zips(conv_dir: Path, zip_dir: Path):+ zip_dir.mkdir(parents=True, exist_ok=True)+ for d in sorted(conv_dir.iterdir()):+ if d.is_dir():+ zp = zip_dir / f"{d.name}.zip"+ with zipfile.ZipFile(zp, 'w', zipfile.ZIP_DEFLATED) as zf:+ for f in d.rglob('*'):+ if f.is_file():+ zf.write(f, f.relative_to(d.parent))+ print(f"📦 {zp.name}")++def main():+ print("🚀 Claude Skills Converter v4 - Formato Markdown ##\n")++ in_dir, out_dir, zip_dir = INPUT_DIR, OUTPUT_DIR, ZIP_DIR+ if not in_dir.exists():+ print(f"❌ Carpeta no encontrada: {in_dir.resolve()}")+ return++ files = set(list(in_dir.rglob('SKILL.md')) + list(in_dir.rglob('skill.md')))+ if not files:+ print("⚠️ No se encontraron archivos SKILL.md")+ return++ print(f"🔍 Encontrados {len(files)} archivos\n")++ # Modo debug: procesar solo 1 archivo+ import sys+ if '--debug' in sys.argv:+ f = sorted(files)[0]+ process_file(f, out_dir, debug=True)+ return++ ok = sum(1 for f in sorted(files) if process_file(f, out_dir))++ if ok:+ print(f"\n📦 Generando {ok} ZIP(s)...")+ create_zips(out_dir, zip_dir)+ print(f"\n✨ {ok}/{len(files)} skills convertidas exitosamente.")+ print(f"📁 Skills: {out_dir.resolve()}")+ print(f"🗜️ ZIPs: {zip_dir.resolve()}")+ print(f"\n📋 Para subir a Claude Console:")+ print(f" • Cada ZIP contiene: [folder-name]/SKILL.md")+ print(f" • El 'name' en YAML = nombre de la carpeta dentro del ZIP")+ else:+ print(f"\n❌ No se pudo convertir ninguna skill. Ejecuta con --debug para diagnosticar.")++if __name__ == '__main__':+ main()\ No newline at end of file