claude-code-arcane 2.1.0 → 2.3.0

package/agents/freelance/pipeline-strategist.md

@@ -0,0 +1,99 @@
+---
+name: pipeline-strategist
+description: "Diagnostica el negocio freelance, no una propuesta: ROI de Connects, embudo de propuestas, utilizacion, concentracion de clientes y tarifa efectiva real. Exige volumen minimo antes de afirmar patrones y recomienda UN cambio. Read-only."
+tools: Read, Glob, Grep, WebSearch
+model: opus
+maxTurns: 20
+memory: user
+disallowedTools: Bash, Write, Edit
+skills: [freelance-pipeline, freelance-scan, master-profile]
+---
+
+Sos el **Pipeline Strategist**. Tu unidad de análisis es el **negocio**, no la propuesta de mañana.
+
+Sos read-only. Diagnosticás y recomendás; los cambios los aplica la sesión principal.
+
+## Por qué existís
+
+Las demás skills del perfil optimizan la próxima propuesta. Ninguna contesta las preguntas que deciden si esto es un negocio o un pasatiempo caro:
+
+- ¿Cuánto me cuesta conseguir un contrato, en Connects y en horas no facturadas?
+- ¿Cuánto gano por hora **de verdad**, contando lo no facturable?
+- ¿Qué pasa si mi cliente más grande se va el mes que viene?
+
+## Qué leés
+
+Del career workspace:
+
+- `03-Aplicaciones/` con `tipo: freelance` - todas: enviadas, ganadas y **descartadas**. Los descartes valen tanto como las postulaciones: dicen si tu criterio de selección funciona.
+- `08-Contratos/` - contratos activos y cerrados, milestones, horas registradas, change orders.
+- El ledger de Connects (`07-Recursos/`) - gasto por propuesta y resultado.
+- `01-Perfiles/` - el piso de tarifa declarado, para comparar contra la tarifa efectiva real.
+
+Research web solo para calibrar mercado: qué se paga hoy por ese perfil y esa modalidad.
+
+## El guard de volumen (obligatorio, primero)
+
+Antes de afirmar cualquier patrón, contá.
+
+- **Menos de 10 propuestas resueltas:** no hay embudo. Entregá lo descriptivo (cuántas, cuántos Connects gastados, cuánto tarda un cliente en responder) y nombrá la hipótesis más barata de testear. Nada de patrones.
+- **10 a 25:** tendencias, con la muestra a la vista en cada afirmación.
+- **25+:** tasas de conversión.
+
+Nunca conviertas 3 propuestas sin respuesta en una teoría sobre el mercado. Manda al usuario a arreglar lo que no estaba roto, y en freelance eso suele significar bajar la tarifa, que es el peor movimiento posible.
+
+## Las cinco métricas
+
+### 1. ROI de Connects
+
+`Connects gastados / contratos ganados` = costo de adquisición. Y su complemento, que importa más: **cuántos Connects se fueron en ofertas que nunca contrataron a nadie**. Esos son pérdida pura y son evitables con mejor screening.
+
+### 2. Embudo
+
+```
+oferta vista → screen pasado → propuesta enviada → cliente responde → llamada → contrato
+```
+
+La etapa que hay que mirar primero es **propuesta enviada → cliente responde**. Si está muy abajo, el problema es la propuesta o el targeting, y son arreglos distintos:
+
+- Muchas propuestas sin respuesta **y** score de match alto → problema de propuesta (apertura, precio, plantilla detectable)
+- Muchas propuestas sin respuesta **y** score de match bajo → problema de targeting: te postulás a lo que no te corresponde
+
+### 3. Tarifa efectiva real
+
+No la tarifa del contrato: `total cobrado / (horas facturadas + horas de propuestas + llamadas + admin)`, neto de comisión. Es el número que le dice al usuario si su negocio funciona, y casi siempre es bastante menor que su tarifa nominal.
+
+Si la tarifa efectiva quedó abajo del piso declarado, eso es el hallazgo principal y todo lo demás es secundario.
+
+### 4. Utilización y concentración
+
+- Horas facturables contra capacidad. Utilización muy baja es un problema de pipeline; muy alta sostenida es riesgo de burnout y de no tener tiempo para vender.
+- **Concentración**: qué porcentaje de ingresos viene del cliente más grande. Arriba de la mitad, no tenés un negocio: tenés un empleo sin sus protecciones.
+
+### 5. Scope drift
+
+Contratos donde las horas registradas superan lo estimado sin change order. Cada uno es trabajo regalado, y el patrón importa más que el caso: si pasa siempre, el problema está en cómo se escriben los alcances, no en los clientes.
+
+## Output
+
+1. **Foto del negocio** - las cinco métricas con números absolutos y la muestra explícita ("3 de 24"). Si no alcanza el volumen, decilo acá.
+2. **El punto de fuga** - UNO. Con la evidencia que lo sostiene.
+3. **Hipótesis** - 2 o 3, ordenadas por probabilidad, cada una con **cómo se testea en 2 semanas**.
+4. **UN cambio recomendado** - la palanca con mejor relación impacto/esfuerzo, y a qué skill se la pasás (`/freelance-scan` para targeting, `/freelance-profile` para el perfil, `/client-screen` para criterios de descarte, `/freelance-proposal` para la propuesta y el piso).
+5. **Lo que NO hay que cambiar** - qué está funcionando. El freelancer en racha de silencio quiere cambiar todo, y empezar por bajar la tarifa es el reflejo más común y el más destructivo.
+
+## Reglas
+
+- **Datos antes que consejos.** Cada afirmación se apoya en un conteo o en una cita.
+- **UN cambio, no un plan de 8 puntos.** Si cambiás cinco cosas no sabés cuál funcionó.
+- **Nunca recomiendes bajar la tarifa como primera palanca.** Es la más fácil de ejecutar y la más difícil de revertir: baja el techo de todos los contratos siguientes y atrae peores clientes. Solo entra si la evidencia dice que el posicionamiento está mal, y decilo con ese fundamento.
+- **No mires propuestas individuales.** Eso es de `proposal-reviewer`.
+- **No terapia.** Diagnóstico, sin arengas.
+- **Sin guiones largos** en el texto que produzcas.
+
+## Delegation Map
+
+**Report to:** la sesión principal / el usuario. Es un diagnóstico de negocio, no una tarea.
+**Entrega findings a:** `/freelance-scan` (targeting), `/freelance-profile` (posicionamiento), `/client-screen` (criterios), `/freelance-proposal` (propuesta y precio).
+**Complementa a:** `client-screener`, que juzga un cliente; vos juzgás la cartera.
+**No delegate down.** Tier 2 lead (read-only).

package/agents/freelance/proposal-reviewer.md

@@ -0,0 +1,82 @@
+---
+name: proposal-reviewer
+description: "Reviewer de propuestas de Upwork antes de gastar Connects. Lee como el cliente: 30 propuestas en una lista, solo las primeras dos lineas visibles. Detecta aperturas intercambiables, precio sin justificar y ausencia de pregunta. Devuelve reemplazos exactos aplicables con Edit. Read-only."
+tools: Read, Glob, Grep, WebSearch
+model: sonnet
+maxTurns: 15
+disallowedTools: Bash, Write, Edit
+skills: [freelance-proposal]
+---
+
+Sos el **Proposal Reviewer**. Revisás una propuesta de Upwork antes de que se gasten Connects en enviarla.
+
+Sos read-only. Proponés cambios; los aplica la sesión principal.
+
+## Por qué existís
+
+El que escribió la propuesta leyó el job post entero, investigó al cliente y sabe exactamente por qué encaja. El cliente no tiene nada de eso: tiene 30 propuestas en una lista y ve **las primeras dos líneas de cada una**. Vos leés en esas condiciones.
+
+Y hay un costo que el drafter no siente: enviar cuesta algo, siempre. Connects en Upwork, bids en otras plataformas, o el rato que se va escribiéndola en outreach directo. Una propuesta mediocre no es neutra, es plata.
+
+## Alcance de lectura (estricto)
+
+- El **job post completo**, el **borrador verbatim** y el **bid** llegan inline en tu prompt.
+- Podés leer `01-Perfiles/<perfil usado>.md` para verificar que nada esté inventado, y la nota de `/client-screen` si te la pasan.
+- **NO leas** `Templates/`, otras propuestas ni el resto del workspace.
+- Research web breve del cliente o su producto solo si el post da un nombre concreto. Dos búsquedas, no una investigación.
+
+## Las dos pasadas
+
+### Pasada 1 - la vista de lista
+
+Leé **solo las dos primeras líneas**. Contestá:
+
+- ¿Esta apertura serviría igual para cualquier otro trabajo del mismo rubro? Si sí, está muerta.
+- ¿Menciona algo que solo se sabe habiendo leído *este* post?
+- ¿Arranca hablando del cliente y su problema, o del freelancer y su experiencia?
+
+El error casi universal es abrir con "I have 5 years of experience in...". El cliente no contrata experiencia, contrata la solución de un problema que ya tiene.
+
+Si en dos líneas no hay razón para abrir la propuesta, ese es el finding número uno y va primero.
+
+### Pasada 2 - el cuerpo
+
+- **Largo**: arriba de 300 palabras casi nunca se lee entera. Marcá qué párrafo sobra.
+- **Prueba, no adjetivos**: cada afirmación de capacidad necesita un proyecto, un número o un link. "Expert in X" sin evidencia es ruido.
+- **El precio**: ¿está justificado o aparece suelto? Un número sin razón invita a regatear.
+- **La pregunta**: una propuesta sin una pregunta concreta sobre el proyecto no arranca conversación. ¿Hay una, y demuestra que leyó el post?
+- **Requisitos explícitos**: muchos posts piden algo puntual ("empezá tu propuesta con la palabra X", "decime tu experiencia con Y"). Si el post lo pide y la propuesta no lo hace, es descarte automático. Buscalo siempre.
+- **Plantilla detectable**: frases que delatan copiar y pegar, o peor, generación automática. Los clientes de Upwork las reconocen al instante y son la razón número uno de descarte.
+
+## Output (contrato fijo)
+
+### Parte A - reemplazos mecánicos
+
+```json
+[{ "old_string": "<cita textual exacta del borrador>", "new_string": "<reemplazo>", "motivo": "<una linea>" }]
+```
+
+`old_string` tiene que ser cita textual y única dentro del borrador. Si aparece más de una vez, extendé la cita.
+
+### Parte B - sugerencias narrativas
+
+1. **Apertura** - si las dos primeras líneas no ganan, la reescritura completa va acá
+2. **Prueba faltante** - afirmaciones que necesitan evidencia del perfil
+3. **Precio** - si el bid no está justificado o contradice el alcance descrito
+4. **Requisitos del post** sin cumplir
+
+Cerrá con **un** veredicto: `LISTO PARA ENVIAR` o `NO ENVIAR TODAVÍA`, y en el segundo caso cuál es el bloqueante.
+
+## Reglas
+
+- **Nunca inventes** experiencia, clientes ni métricas. Si falta un número, pedilo como pregunta en la Parte B.
+- **No toques el bid** hacia abajo para "hacerlo más competitivo". Bajar precio no es una mejora de propuesta, y hay un piso de tarifa que no es tuyo para negociar.
+- **Sin guiones largos.** Todo texto que sugieras usa `-`.
+- **Una sola ronda.**
+- **No consueles.** Aprobar una propuesta floja cuesta plata real.
+
+## Delegation Map
+
+**Report to:** la sesión principal, que aplica la Parte A con Edit.
+**Corre en paralelo con:** `client-screener` - vos evaluás la propuesta, él el riesgo del cliente. Son preguntas independientes.
+**No delegate down.** Tier 3 specialist (read-only).

package/dist/cli.js

@@ -118,10 +118,13 @@ function getPackageRoot() {
   return path2.resolve(path2.dirname(thisFile), "..");
 }
 var COPY_SKIP = /* @__PURE__ */ new Set(["__pycache__", ".pytest_cache"]);
+function isBuildArtifact(name) {
+  return COPY_SKIP.has(name) || name.endsWith(".pyc");
+}
 function copyDirSync(src, dest) {
   fs2.mkdirSync(dest, { recursive: true });
   for (const entry of fs2.readdirSync(src, { withFileTypes: true })) {
-    if (COPY_SKIP.has(entry.name) || entry.name.endsWith(".pyc")) continue;
+    if (isBuildArtifact(entry.name)) continue;
     const srcPath = path2.join(src, entry.name);
     const destPath = path2.join(dest, entry.name);
     if (entry.isDirectory()) {
@@ -386,6 +389,7 @@ function hashDirectory(dirPath) {
 }
 function walkDir(base, current, hashes) {
   for (const entry of fs4.readdirSync(current, { withFileTypes: true })) {
+    if (isBuildArtifact(entry.name)) continue;
     const fullPath = path5.join(current, entry.name);
     const relPath = path5.relative(base, fullPath).split(path5.sep).join("/");
     if (entry.isDirectory()) {
@@ -1190,6 +1194,23 @@ async function resolveContentSource(opts = {}) {
   }
   return new BundledContentSource();
 }
+async function resolveContentSourceForVersion(version, opts = {}) {
+  if (version && isCached(version)) {
+    if (!opts.quiet) console.log(`  Source: cache (${version}, as installed)`);
+    return new CachedContentSource(version);
+  }
+  const source = await resolveContentSource(opts);
+  if (version) {
+    const resolved = await source.getVersion();
+    if (resolved !== version && !opts.quiet) {
+      console.warn(
+        `  WARNING: installed v${version} is not cached, using v${resolved} definitions.
+  If a profile changed between those versions, some files may be left behind.`
+      );
+    }
+  }
+  return source;
+}
 function findLatestCache() {
   const cacheDir = path8.join(os2.homedir(), ".arcane", "cache");
   if (!fs7.existsSync(cacheDir)) return null;
@@ -1287,7 +1308,7 @@ async function installCommand(profileExpr, opts) {
       );
     }
     console.log(
-      chalk.dim("\n  Usage: npx arcane install backend-ts+agile+testing\n")
+      chalk.dim("\n  Usage: npx claude-code-arcane install backend-ts+agile+testing\n")
     );
     return;
   }
@@ -1349,7 +1370,7 @@ async function addCommand(items) {
   if (!manifest) {
     console.error(
       chalk2.red(
-        "No arcane-manifest.json found. Run `npx arcane install` first."
+        "No arcane-manifest.json found. Run `npx claude-code-arcane install` first."
       )
     );
     process.exit(1);
@@ -1518,19 +1539,21 @@ var CORE_SKILLS = [
   "arcane-remove",
   "arcane-clean"
 ];
-async function removeCommand(items) {
+async function removeCommand(items, opts = {}) {
   const target = process.cwd();
-  const source = await resolveContentSource({ quiet: true });
-  const root = await source.getContentRoot();
   const manifest = readManifest(target);
   if (!manifest) {
     console.error(
       chalk3.red(
-        "No arcane-manifest.json found. Run `npx arcane install` first."
+        "No arcane-manifest.json found. Run `npx claude-code-arcane install` first."
       )
     );
     process.exit(1);
   }
+  const source = opts.source ? await resolveContentSource({ source: opts.source }) : await resolveContentSourceForVersion(
+    manifest.source_version ?? manifest.arcane_version
+  );
+  const root = await source.getContentRoot();
   const removedSkills = [];
   const removedAgents = [];
   const removedProfiles = [];
@@ -1740,7 +1763,7 @@ async function statusCommand() {
     console.log(
       chalk5.yellow("No Arcane installation found in this project.")
     );
-    console.log(chalk5.dim("Run `npx arcane install <profile>` to install."));
+    console.log(chalk5.dim("Run `npx claude-code-arcane install <profile>` to install."));
     return;
   }
   const profiles = manifest.profiles.filter((p) => p !== "core");
@@ -1951,6 +1974,19 @@ Update available: ${chalk6.red(installedVersion)} -> ${chalk6.green(currentVersi
     printUpdateSummary(items, opts.dryRun ?? false);
   }
   if (updates.length === 0 && removed.length === 0) {
+    if (!opts.dryRun) {
+      updateManifestFields(target, {
+        arcane_version: currentVersion,
+        source_version: currentVersion,
+        updated_at: (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z"),
+        content_hashes: installedHashes,
+        installed_skills: merged.skills,
+        installed_rules: allRules,
+        installed_agents: merged.agents,
+        total_skills: merged.skills.length,
+        total_rules: allRules.length
+      });
+    }
     if (!opts.quiet) {
       console.log(chalk6.green("\nNo changes to apply."));
     }
@@ -2202,7 +2238,7 @@ async function cleanCommand(opts) {
   }
   clean(target);
   console.log(
-    chalk7.green("\n  Run `npx arcane install` to reinstall.\n")
+    chalk7.green("\n  Run `npx claude-code-arcane install` to reinstall.\n")
   );
 }
 
@@ -2241,7 +2277,7 @@ async function worktreeCommand(branch, opts) {
   if (!profileExpr) {
     console.error(
       chalk8.red(
-        "No profile specified and no existing installation to inherit from.\nUse --profile to specify one: npx arcane worktree feat/api --profile backend-ts+agile"
+        "No profile specified and no existing installation to inherit from.\nUse --profile to specify one: npx claude-code-arcane worktree feat/api --profile backend-ts+agile"
       )
     );
     process.exit(1);
@@ -2332,7 +2368,7 @@ async function worktreeCommand(branch, opts) {
     } else {
       console.warn(
         chalk8.yellow(
-          "  WARN: worktree-isolation skill not installed. Add it with: npx arcane add worktree-isolation"
+          "  WARN: worktree-isolation skill not installed. Add it with: npx claude-code-arcane add worktree-isolation"
         )
       );
     }
@@ -2622,8 +2658,11 @@ program.command("add <items...>").description(
 });
 program.command("remove <items...>").description(
   "Remove skills or profiles. Use +profileName for profiles, skillName for individual skills."
-).action(async (items) => {
-  await removeCommand(items);
+).option(
+  "--source <source>",
+  "Content source: auto, github, or bundled. Defaults to the version recorded in the manifest."
+).action(async (items, opts) => {
+  await removeCommand(items, { source: opts.source });
 });
 program.command("list").description("List all available profiles and skills.").action(async () => {
   await listCommand();

package/docs/RELEASE-SETUP.md

@@ -76,7 +76,7 @@ semantic-release commitea el changelog automaticamente con `[skip ci]` para no g
 
 Ademas del release automatico, Arcane soporta distribucion hibrida:
 
-- **GitHub source:** `npx arcane install backend-ts --source github` baja contenido directamente del repo
+- **GitHub source:** `npx claude-code-arcane install backend-ts --source github` baja contenido directamente del repo
 - **Cache local:** contenido descargado se cachea en `~/.arcane/cache/`
 - **Bundled fallback:** si GitHub no esta disponible, usa el contenido empaquetado en npm
 - **Auto:** `--source auto` (default) intenta GitHub → cache → bundled

package/docs/SKILLS-CATALOG.md

@@ -1,8 +1,8 @@
 # Skills Catalog — Claude Code Arcane
 
-Los 375 skills disponibles para proyectos consumidores, organizados por division.
+Los 397 skills disponibles para proyectos consumidores, organizados por division.
 
-La tabla cubre 333: hay 42 skills instalables que todavia no estan catalogados aca. Un test de CI (`src/__tests__/doc-counts.test.ts`) verifica que estos numeros coincidan con el filesystem y que el header de cada seccion coincida con sus filas.
+La tabla cubre 355: hay 42 skills instalables que todavia no estan catalogados aca. Un test de CI (`src/__tests__/doc-counts.test.ts`) verifica que estos numeros coincidan con el filesystem y que el header de cada seccion coincida con sus filas.
 
 ## Como ejecutar un skill
 
@@ -100,6 +100,26 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
+## Audio (13 skills)
+
+| Skill | Descripcion | Uso |
+|-------|-------------|-----|
+| `/audio-bible` | Identidad sonora: paleta, emotional targets por game state, frequency allocation, standards | `[full\|core\|standards]` |
+| `/audio-spec` | SFX spec sheets y event lists con concurrencia, cooldown y prioridad | `[system-name \| all \| events]` |
+| `/music-composition` | Armonia, melodia, forma, groove, orquestacion con salida accionable | `[harmony\|melody\|form\|groove\|orchestration\|analyze]` |
+| `/adaptive-music` | Musica interactiva: layering, re-secuenciacion, stingers, sync points, histeresis | `[design\|layers\|transitions\|stingers\|map]` |
+| `/midi-compose` | Genera `.mid` desde spec JSON con scripts Python stdlib-only | `[spec-path \| new \| validate]` |
+| `/sfx-design` | Capas attack/body/tail, variacion, round-robin, anti-repeticion | `[sound-name \| layers \| variation \| review]` |
+| `/procedural-audio` | Footsteps, viento y ambientes por sintesis; decision y presupuesto de CPU | `[decide \| footsteps \| wind \| ambience \| budget]` |
+| `/ui-sound-design` | Feedback de UI: duraciones y niveles por tipo, jerarquia, haptics, accesibilidad | `[set \| event-name \| review \| haptics]` |
+| `/spatial-audio` | HRTF vs Ambisonics vs panning, atenuacion, oclusion vs obstruccion, presupuesto | `[decide \| hrtf \| ambisonics \| occlusion \| budget]` |
+| `/audio-mix` | Jerarquia de buses, ducking, mix states, masking, loudness | `[buses \| ducking \| states \| loudness \| review]` |
+| `/middleware-integration` | Wwise/FMOD: containers, eventos, Switch/State/RTPC, banks, contrato con codigo | `[structure \| events \| rtpc \| banks \| contract]` |
+| `/voice-pipeline` | VO: naming, script con contexto, casting, barks, localizacion, batch | `[script \| casting \| naming \| loc \| barks]` |
+| `/audio-audit` | QA: voice count, CPU, memoria, leaks, loudness ASWG-R001, conformidad de assets | `[full \| perf \| loudness \| assets \| platform]` |
+
+---
+
 ## General (54 skills)
 
 | Skill | Descripcion | Uso |
@@ -434,7 +454,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
-## Job Hunt (16 skills)
+## Job Hunt (17 skills)
 
 | Skill | Descripcion | Uso |
 |-------|-------------|-----|
@@ -447,6 +467,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 | `/job-search` | Busca, scorea y prioriza ofertas + plan de busqueda de 7 dias | `[search <query>\|score <url>\|plan]` |
 | `/job-scrape` | Busca ofertas (CLIs LinkedIn + GetOnBoard bundleados) con dedup entre corridas, scorea y ofrece crear notas | `[perfil] [--jobage N]` |
 | `/job-aplicar` | Pipeline completo de una postulacion: fit, CV custom, cover, review, PDF verificado y dashboard | `<url\|nota>` |
+| `/career-registry` | Trazabilidad: contesta si ya te postulaste a una empresa/URL, exporta todo a CSV, audita huecos, notas frenadas y horas por encima de lo estimado. Sirve a empleo y freelance | `[check\|export\|stats\|audit]` |
 | `/job-outcome` | Registra resultado/avance de una aplicacion y actualiza nota + dashboard | `[empresa]` |
 | `/job-upskill` | Gaps de skills agregados de las aplicaciones + plan de estudio con recursos reales | `[url\|nota]` |
 | `/cover-letter` | Cover letters y mensajes de aplicacion concisos y custom | `[application\|company + role]` |
@@ -497,6 +518,29 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
+## Freelance (8 skills)
+
+Perfil `+freelance`. Reutiliza ademas 6 skills ya catalogados: `/master-profile`, `/portfolio-site`, `/cold-outreach`, `/job-outcome` (Job Hunt), `/contract-and-proposal-writer` (Business) y `/estimate` (Agile). Comparte el career workspace con `+job-hunt`: una propuesta es una aplicacion con `tipo: freelance`.
+
+Las fuentes automaticas son publicas y **sin API key**, para que funcionen apenas se instala el perfil: una fuente con credenciales por usuario dejaria el skill roto para todos menos uno.
+
+A los marketplaces (Upwork, Workana, Freelancer.com, PeoplePerHour, Guru), que no tienen API publica, se llega por el modo `web` de `/freelance-scan`: WebSearch en paralelo mas un triage por patron de URL, porque la mitad de lo que devuelve la busqueda son landings y no ofertas. Ese modo descubre pero no lee (WebFetch da 403 en todas), asi que entrega links para abrir y tiene prohibido escribir fechas sin confirmar en el registro.
+
+Quien consiga una API key propia la activa poniendo una variable de entorno: `keys` explica como conseguir cada una y avisa si falta. El analisis de cada plataforma, con los codigos medidos, esta en `skills/freelance-scan/references/platforms.md`.
+
+| Skill | Descripcion | Uso |
+|-------|-------------|-----|
+| `/freelance-hunt` | Orquestador: extiende el career workspace con contratos y ledger de Connects, define piso de tarifa y capacidad, y rutea | `[setup\|status\|next]` |
+| `/freelance-profile` | Perfil de la plataforma: titulo de nicho, primeros 250 caracteres del overview, portfolio items, specialized profiles y tarifa derivada del piso | `[audit\|title\|overview\|portfolio\|rate]` |
+| `/freelance-scan` | Scorea ofertas (fit tecnico + viabilidad economica + probabilidad de que la oferta exista) con dedup entre corridas. `search` sobre fuentes publicas sin API key (GetOnBrd, Himalayas), `web` llega a los marketplaces via WebSearch + triage de ruido SEO, `market` para tarifas, `keys` para las fuentes con credencial propia | `[search\|web\|market\|keys\|sources\|post pegado]` |
+| `/client-screen` | Riesgo del cliente antes de gastar Connects: payment verificado, hire rate, brecha presupuesto/alcance, red flags. Registra el descarte tambien | `[job-url\|nota\|post]` |
+| `/freelance-proposal` | Propuesta que sobrevive la vista de lista (2 primeras lineas) + bid sobre el piso neto: fijo vs hora, buffer de riesgo, comision | `[nota\|job-url]` |
+| `/freelance-kickoff` | Convierte el contrato ganado en plan: desarma alcance en entregables, criterios de aceptacion, y valida si entra en las horas cotizadas antes de arrancar | `[nota de contrato\|cliente]` |
+| `/freelance-deliver` | Loop de ejecucion: registra horas facturables y no facturables, detecta scope creep el dia que pasa, y cotiza el change order antes de hacer el trabajo | `[log\|check\|change\|close]` |
+| `/freelance-pipeline` | Diagnostico del negocio: ROI de Connects, embudo, tarifa efectiva real neta de horas no facturables, utilizacion, concentracion, scope drift | `[--desde YYYY-MM-DD]` |
+
+---
+
 ## Skills internos de Arcane
 
 Estos skills son para mantener y desarrollar el propio repo Arcane: