claude-code-arcane 1.2.0 → 1.3.0

package/skills/network-map/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: network-map
+description: "Turn your LinkedIn connections data export into warm-intro intelligence: find your 1st-degree contacts at a target company, identify likely warm-intro paths, and draft a tailored outreach message per contact. Triggers: red de contactos, networking LinkedIn, contactos en una empresa, warm intro, referido, quien conozco en, LinkedIn connections export."
+argument-hint: "[company] | import <path-to-Connections.csv>"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+
+# Network Map — Inteligencia de contactos para warm intros
+
+Convertís el **export de conexiones de LinkedIn** en inteligencia accionable: dado un target company, quién de tu red 1er-grado trabaja (o trabajó) ahí, quién puede darte un warm intro, y un mensaje custom por contacto. Reemplaza a LinkedIn Premium para esto: solo necesitás tu propio export + Claude.
+
+## Conseguir el export (una vez)
+
+En LinkedIn → **Settings → Data Privacy → Get a copy of your data → Download**. En el ZIP viene `Connections.csv` (tus 1er-grado con nombre, URL, empresa, posición, fecha de conexión). Pasáselo a la skill.
+
+> **Privacidad:** `Connections.csv` es data personal de terceros. Guardalo en `05-Contactos/` del workspace y **nunca** lo commitees a un remoto. Trabajalo localmente.
+
+## Qué produce
+
+Dado un target company:
+1. **1er-grado en la empresa** — contactos tuyos que trabajan ahí ahora (match por `Company`).
+2. **Paths de warm intro** — contactos 1er-grado que probablemente conozcan gente del target (ej. ex-empleados de la empresa, gente del mismo rubro/rol) y podrían presentarte. *Nota honesta:* el export solo tiene tus 1er-grado; el verdadero 2do-grado (las conexiones de ellos) no está en el archivo. Lo que hacemos es **inferir** buenos candidatos a intro desde tus 1er-grado (empleo actual/pasado en el target, overlap de empresa/rol), no leer la red de cada uno.
+3. **Mensaje por contacto** — template custom según historia compartida (misma empresa pasada, mismo rubro, conexión vieja vs reciente).
+
+## El motor
+
+`scripts/network_map.py` parsea `Connections.csv` (maneja el preámbulo del export) y filtra/rankea por empresa.
+
+```bash
+# Contactos en una empresa
+python scripts/network_map.py --csv "05-Contactos/Connections.csv" --company "Acme"
+
+# Top empresas donde tenés más contactos (descubrir oportunidades)
+python scripts/network_map.py --csv "05-Contactos/Connections.csv" --top-companies
+```
+
+Devuelve nombre, posición, empresa, URL del perfil y fecha de conexión. Vos (Claude) tomás esa salida y armás los paths de intro y los mensajes.
+
+## Modos
+
+### `import <path>` — Registrar el export
+Copiar/referenciar `Connections.csv` en `05-Contactos/`, verificar que parsea (corré el script con `--top-companies`), y reportar tamaño de la red + top empresas.
+
+### `[company]` — Mapear una empresa
+1. Correr el script filtrando por la empresa.
+2. Clasificar: 1er-grado actuales en la empresa vs candidatos a warm-intro (ex-empleados / mismo rubro).
+3. Priorizar por relevancia (seniority/rol vs tu objetivo) y calidez (conexión reciente, historia compartida).
+4. Draftear un mensaje por contacto top (apoyate en `/cold-outreach` para el tono y los templates).
+5. Guardar contactos relevantes como notas en `05-Contactos/` (template `Contacto`).
+
+## Reglas
+
+- Data de terceros: tratamiento local, nunca a un remoto sin confirmación; respetá privacidad.
+- No inventar relaciones ni 2do-grado que el export no soporta — sé explícito sobre qué es dato y qué es inferencia.
+- Calidad sobre cantidad: 5 contactos bien elegidos > 50 mensajes genéricos.
+
+## Handoff
+
+Pedí aprobación (approval) antes de escribir notas de contacto o copiar el CSV al workspace. Cuando el mapa está READY, el siguiente paso es `/cold-outreach` para redactar los mensajes y agendar follow-ups.

package/skills/network-map/scripts/network_map.py

@@ -0,0 +1,109 @@
+"""
+network_map.py — Parse a LinkedIn "Connections.csv" data export and query it.
+
+LinkedIn's export prepends a few notice lines before the real CSV header
+(First Name, Last Name, URL, Email Address, Company, Position, Connected On).
+This script skips that preamble, then lets you:
+
+    # contacts at a target company (substring, case-insensitive)
+    python network_map.py --csv Connections.csv --company "Acme"
+
+    # companies where you have the most connections
+    python network_map.py --csv Connections.csv --top-companies [N]
+
+Output is a simple table to stdout. The skill turns it into intro paths
+and tailored messages — this script only does the data wrangling.
+
+Privacy: Connections.csv is third-party personal data. Keep it local.
+"""
+
+import argparse
+import csv
+import sys
+from collections import Counter
+from pathlib import Path
+
+EXPECTED_COLS = {"First Name", "Last Name", "Company", "Position"}
+
+
+def load_rows(csv_path):
+    """Read the export, skipping the notice preamble before the header row."""
+    raw = Path(csv_path).read_text(encoding="utf-8", errors="replace").splitlines()
+    header_idx = None
+    for i, line in enumerate(raw):
+        # The real header contains these column names.
+        if "First Name" in line and "Last Name" in line:
+            header_idx = i
+            break
+    if header_idx is None:
+        print("[ERROR] Could not find the CSV header (First Name, Last Name, ...).")
+        print("        Is this the LinkedIn Connections.csv export?")
+        sys.exit(1)
+
+    reader = csv.DictReader(raw[header_idx:])
+    rows = []
+    for r in reader:
+        rows.append({k.strip(): (v or "").strip() for k, v in r.items() if k})
+    return rows
+
+
+def fullname(r):
+    return f"{r.get('First Name', '')} {r.get('Last Name', '')}".strip()
+
+
+def query_company(rows, company):
+    needle = company.lower()
+    hits = [r for r in rows if needle in r.get("Company", "").lower()]
+    hits.sort(key=lambda r: r.get("Connected On", ""), reverse=True)
+    if not hits:
+        print(f"No 1st-degree connections matched company '{company}'.")
+        return
+    print(f"{len(hits)} connection(s) matching '{company}':\n")
+    for r in hits:
+        print(f"- {fullname(r)} - {r.get('Position','?')} @ {r.get('Company','?')}")
+        url = r.get("URL", "")
+        if url:
+            print(f"    {url}")
+        if r.get("Connected On"):
+            print(f"    connected: {r['Connected On']}")
+
+
+def top_companies(rows, n):
+    counts = Counter(r.get("Company", "") for r in rows if r.get("Company"))
+    print(f"Total connections: {len(rows)}")
+    print(f"Distinct companies: {len(counts)}\n")
+    print(f"Top {n} companies by connection count:")
+    for company, c in counts.most_common(n):
+        print(f"  {c:>4}  {company}")
+
+
+def main():
+    ap = argparse.ArgumentParser(description="Query a LinkedIn Connections.csv export.")
+    ap.add_argument("--csv", required=True, help="path to Connections.csv")
+    ap.add_argument("--company", help="filter connections by company (substring)")
+    ap.add_argument(
+        "--top-companies",
+        nargs="?",
+        const=20,
+        type=int,
+        help="list the top N companies by connection count (default 20)",
+    )
+    args = ap.parse_args()
+
+    if not Path(args.csv).exists():
+        print(f"[ERROR] Not found: {args.csv}")
+        sys.exit(1)
+
+    rows = load_rows(args.csv)
+
+    if args.company:
+        query_company(rows, args.company)
+    elif args.top_companies is not None:
+        top_companies(rows, args.top_companies)
+    else:
+        # default: overview
+        top_companies(rows, 20)
+
+
+if __name__ == "__main__":
+    main()

package/skills/personal-brand/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: personal-brand
+description: "Build a job-search personal brand on LinkedIn: generate a sequenced backlog of post ideas across credibility pillars (1 post/day) that builds authority before outreach. Triggers: marca personal, personal brand, contenido LinkedIn, post ideas LinkedIn, calendario de contenido, autoridad LinkedIn, 1 post por dia, construir audiencia para buscar trabajo."
+argument-hint: "[plan | ideas <N> | draft <idea>]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit
+---
+
+# Personal Brand — Autoridad en LinkedIn para la búsqueda
+
+Construís una marca personal en LinkedIn orientada a conseguir trabajo: un backlog **secuenciado** de ideas de post (ritmo 1/día) que construye autoridad y credibilidad *antes* de salir a hacer outreach, de modo que cuando escribas a un recruiter ya tengan contexto de quién sos.
+
+Trabajás contra el **perfil maestro** (`01-Perfiles/`) y el rol/empresas objetivo. Output: un plan de contenido en `01-Perfiles/Personal Brand.md` (o `07-Recursos/`).
+
+## Los 4 pilares
+
+1. **Builder credibility** — qué construiste/entregaste, con resultados. Demuestra que hacés, no solo que sabés.
+2. **Lessons from current role** — aprendizajes concretos del trabajo actual/reciente (técnicos y de proceso).
+3. **POVs on your domain** — opiniones/tendencias de tu dominio. Te posiciona como alguien que piensa, no solo ejecuta.
+4. **Behind-the-scenes of the job search** — el viaje de la búsqueda (en su justa medida): genera cercanía y a veces atrae oportunidades directas.
+
+Ver `references/post-pillars.md` para ángulos, hooks y formatos por pilar.
+
+## Modos
+
+### `plan` — Backlog de 90 ideas secuenciadas
+1. Confirmar rol objetivo, empresas y los temas donde el usuario tiene autoridad real (del perfil maestro).
+2. Generar **90 ideas** repartidas en los 4 pilares. Cada idea = **hook + ángulo + formato** (texto, carrusel, lista, story, hot-take).
+3. **Secuenciar**: los primeros ~30 días priorizan pilares 1–3 (construir autoridad); recién después meter más del pilar 4 y empujar el outreach. La autoridad va antes que el pedido.
+4. Entregar como tabla/calendario (día → idea → pilar → formato).
+
+### `ideas <N>` — Lote de N ideas
+Generar N ideas frescas para un pilar o tema puntual, mismo formato hook+ángulo+formato.
+
+### `draft <idea>` — Escribir un post
+Convertir una idea en un post listo para publicar: hook fuerte en la primera línea, cuerpo escaneable, CTA o pregunta de cierre. Tono humano, sin clichés de LinkedIn ("I'm humbled to announce…").
+
+## Principios
+
+- **Hook primero.** La primera línea decide si lo leen (en el feed se ve cortado). Específico, con tensión o número.
+- **Mostrar, no proclamar.** "Reduje el deploy de 40min a 4" > "Soy bueno en CI/CD".
+- **Una idea por post.** Foco.
+- **Consistencia > perfección.** El plan asume ritmo sostenible; mejor 1/día simple que 1/semana elaborado.
+- **Autoridad antes que pedido.** No arranques pidiendo trabajo; primero aportá valor.
+- **Verdad.** Nada de logros inflados — la audiencia y los recruiters lo notan.
+
+## Idioma
+
+Según tu audiencia objetivo: inglés para alcance internacional, español si tu mercado es local. Se puede alternar.
+
+## Handoff
+
+Pedí aprobación (approval) antes de escribir el plan en el workspace. Cuando el backlog está READY, combinalo con `/linkedin-optimize` (perfil a tono con el contenido) y, tras ~30 días de autoridad, con `/cold-outreach` para el outreach.

package/skills/personal-brand/references/post-pillars.md

@@ -0,0 +1,66 @@
+# Post Pillars — Ángulos, hooks y formatos
+
+Guía para generar ideas con sustancia por cada uno de los 4 pilares. Cada idea final = **hook + ángulo + formato**.
+
+## Formatos disponibles
+
+- **Text post corto** — 1 idea, 3–6 líneas, hook fuerte.
+- **Lista / "X things"** — escaneable, alto guardado.
+- **Carrusel** — paso a paso o framework (si el usuario hace slides).
+- **Hot take / POV** — opinión con tensión, invita a debate.
+- **Story / mini-caso** — situación → acción → resultado (mini-STAR público).
+- **Pregunta** — abre conversación, sube engagement.
+
+## Pilar 1 — Builder credibility
+
+Demostrar que entregás. Ángulos:
+- Un problema real que resolviste + el número de impacto.
+- "Cómo construí X" (decisiones técnicas, trade-offs).
+- Antes/después de un sistema o métrica.
+- Una herramienta/proyecto propio y por qué lo hiciste.
+
+Hooks ejemplo: *"Bajé la latencia de matchmaking 25%. El cambio que más movió la aguja no fue el que esperaba."*
+
+## Pilar 2 — Lessons from current role
+
+Aprendizajes concretos, no abstractos. Ángulos:
+- Un error que cometiste y qué cambiaste.
+- Algo contraintuitivo que aprendiste este trimestre.
+- Una práctica de equipo que sí funciona (y por qué).
+- "Lo que ojalá hubiera sabido cuando empecé con X".
+
+Hooks ejemplo: *"Pasé 2 años optimizando lo que no importaba. Esto es lo que mido ahora."*
+
+## Pilar 3 — POVs on your domain
+
+Posicionarte como alguien que piensa el dominio. Ángulos:
+- Una tendencia y por qué estás de acuerdo / en contra.
+- Un mito común de tu campo, desarmado.
+- Predicción fundamentada sobre hacia dónde va X.
+- Comparación honesta entre dos enfoques/herramientas.
+
+Hooks ejemplo: *"Todos dicen que [tendencia]. En producción, lo que veo es otra cosa."*
+
+## Pilar 4 — Behind-the-scenes del job search
+
+Cercanía + a veces atrae ofertas directas. Usar con medida (no quejas). Ángulos:
+- Qué buscás y por qué (señal clara para recruiters).
+- Un aprendizaje del proceso de búsqueda/entrevistas.
+- Reflexión sobre qué valorás en un equipo/empresa.
+- Agradecimiento o lección de una entrevista (sin nombres negativos).
+
+Hooks ejemplo: *"Estoy buscando mi próximo rol como [rol]. Esto es exactamente lo que aporto y lo que busco."*
+
+## Secuenciación (90 días)
+
+- **Días 1–30 (autoridad):** ~70% pilares 1–3, ~30% pilar 2. Casi nada de "busco trabajo" todavía — primero construís credibilidad.
+- **Días 31–60 (visibilidad + señal):** introducir pilar 4 (qué buscás), mantener 1–3. Empezar outreach (`/cold-outreach`) apoyado en los posts.
+- **Días 61–90 (conversión):** mezclar los 4, más casos de builder credibility, CTAs suaves hacia conversaciones.
+
+## Anti-patrones
+
+- Clichés de LinkedIn ("I'm humbled/thrilled to announce…").
+- Posts sin punto de vista (solo "compartiendo este artículo").
+- Humblebrag vacío sin aprendizaje ni dato.
+- Quejarse del proceso de búsqueda o de empresas con nombre.
+- Más de una idea por post.

package/skills/portfolio-site/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: portfolio-site
+description: "Build or update a personal portfolio website from a single source-of-truth profile. Two modes: sync content into an existing portfolio repo, or scaffold a new portfolio site. Triggers: portfolio web, pagina personal, actualizar portfolio, sincronizar portfolio, crear portfolio, sitio personal de desarrollador, portfolio React."
+argument-hint: "[sync | scaffold] [repo-path | --new]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit, WebFetch
+---
+
+# Portfolio Site — Portfolio web desde el source-of-truth
+
+Generás o actualizás un **portfolio web personal** a partir de un único source-of-truth (`portfolio/Datos Portfolio Web.md` en el career workspace, derivado del perfil maestro). La regla: **el contenido se edita primero en el `.md`** y de ahí se sincroniza al sitio.
+
+## El source-of-truth
+
+`portfolio/Datos Portfolio Web.md` contiene, en una estructura estable, todo lo que va al sitio: personal info (con email **público** separado del personal), bios (corto/medio/largo), experiencia, educación, certificaciones, skills con niveles/%, proyectos (con links en vivo), achievements, idiomas, referencias. Si no existe, derivalo del perfil maestro (`/master-profile`).
+
+Convención: **valores en inglés** (van directo al sitio) y meta-instrucciones en español.
+
+## Modos
+
+### `sync` — Actualizar un portfolio existente
+Para cuando ya hay un repo de portfolio (ej. una React SPA con el contenido en `src/pages/*.js`, `src/data/*`, o similar).
+
+1. Leer el source-of-truth y el repo destino.
+2. Mapear cada sección del `.md` a dónde vive en el sitio (componentes/datos).
+3. Detectar **drift**: qué está desactualizado en el sitio vs el `.md` (roles nuevos, fechas, proyectos, nivel de idioma). El source-of-truth manda.
+4. Aplicar los cambios al sitio respetando su arquitectura y estilo de código existentes.
+5. Verificar (build/preview) y resumir el diff.
+
+### `scaffold` — Crear un portfolio nuevo
+Para cuando no hay sitio todavía.
+
+1. Preguntar el stack preferido (default sugerido: **sitio estático simple** — HTML/CSS o un framework liviano como Astro/Vite — fácil de hostear en GitHub Pages/Netlify).
+2. Preguntar secciones deseadas (hero, about, experiencia, proyectos, skills, contacto).
+3. Generar el proyecto consumiendo el source-of-truth como contenido.
+4. Configurar deploy (GitHub Pages / Netlify) si el usuario quiere.
+5. Documentar cómo correr `sync` a futuro.
+
+## Secciones típicas
+
+- **Hero** — nombre, headline, bio corto, links (GitHub/LinkedIn/email público).
+- **About** — bio medio/largo.
+- **Experience** — roles con highlights.
+- **Projects** — los destacados, con tech, descripción corta y link en vivo.
+- **Skills** — agrupados, con nivel/%.
+- **Contact** — email **público** (nunca el personal), formulario o links.
+
+## Reglas
+
+- **El `.md` es la fuente.** Nunca editar el sitio sin reflejarlo en el source-of-truth (si no, vuelve el drift).
+- Email **público** en el sitio, jamás el personal/teléfono.
+- Respetar la arquitectura y el estilo del repo existente en modo `sync` — no reescribir todo.
+- En `scaffold`, mantenerlo simple y rápido de hostear salvo que el usuario pida otra cosa.
+- No subir datos sensibles; el portfolio es público.
+
+## Handoff
+
+Pedí aprobación (approval) antes de escribir en el repo del portfolio o scaffoldear un sitio nuevo. Cuando el sitio está READY/sincronizado, volvé a `/job-hunt status` para seguir con las aplicaciones.