Skip to content

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.py
new file mode 100644
index 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