Communitygithub.com

Flagrare/agent-skills

Construye y mantiene un mapa de promoción con fuentes verificadas para el próximo nivel del usuario. Entrevista al usuario sobre su objetivo, investiga cómo funcionan realmente las promociones en su empresa y escribe un mapa local y privado.

¿Qué es agent-skills?

Esta habilidad está diseñada para ayudar a desarrolladores e ingenieros a planificar su próxima promoción profesional de manera estratégica y basada en datos. El agente entrevista al usuario para comprender su objetivo (nivel, trayectoria, ciclo y motivación), investiga los procesos, calendarios, plantillas y rúbricas de evaluación de la empresa. Mapea la organización, identifica quién tiene conocimiento de primera mano del trabajo del usuario y calcula cuándo hablar con su gerente. Cada hecho registrado incluye una fuente, fecha y estado (verificado, no verificado o inferido), y las fuentes conflictivas se muestran explícitamente, sin resolverse en silencio. La herramienta escribe los archivos `promotion-map.md` y `promotion-map.json` en `~/.claude/skills/flagrare/career/`, que otras habilidades de carrera (impact-scan, opportunity-scan) pueden leer. Es compatible con entornos de línea de comandos y se activa con frases como 'promoción', 'plan de promoción', '¿cómo funcionan las promociones aquí?', o '¿estoy listo para senior?'. El proceso consta de cuatro fases: objetivos e investigación, análisis de brechas de rúbrica, mapeo de la organización y red de contactos, y planificación de fechas y acciones concretas.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Flagrare/agent-skills/tree/HEAD/plugins/flagrare/skills/promotion

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Promoción

Sin guiones largos. Nada de lo que escriba esta habilidad puede contener un guión largo; use una coma, dos puntos o paréntesis. Esto se aplica mediante un hook del repositorio. Ver /flagrare:write-docs.

Palabras llanas. En todo lo que el usuario lea, use los nombres simples definidos en <plugin root>/lib/career/GLOSSARY.md ("comportamientos de Senior", no "filas de la rúbrica"; "tu caso escrito", no "packet"; "el proyecto que lideras", no "iniciativa"). La primera vez que aparezca un término, explique su significado en pocas palabras y añada la palabra que la empresa usa entre paréntesis cuando el usuario la oiga en el trabajo.

Una promoción se decide en una sala donde el usuario no está, a partir de un caso escrito, por personas que en su mayoría no lo conocen, en un calendario fijado con meses de antelación. Esta habilidad hace visibles esos hechos desde el principio: hacia dónde quiere ir el usuario y por qué, cómo decide realmente la empresa, qué pide la rúbrica, quién tiene conocimiento de primera mano de su trabajo y cuándo deben ocurrir las conversaciones clave.

Escribe un mapa de promoción: promotion-map.md para que el usuario lo lea y lo lleve a una reunión 1:1, y promotion-map.json con los mismos datos para las demás habilidades de carrera. El mapa es local y privado. Esta habilidad nunca publica, envía ni difunde nada.

Librería

El plugin incluye scripts auxiliares en <plugin root>/lib/career/. La raíz del plugin está dos directorios por encima del directorio base de esta habilidad. Ejecute cada uno como python3 <plugin root>/lib/career/<script>.py .... Solo leen e imprimen JSON; esta habilidad escribe cada archivo con la herramienta de escritura, porque una shell en una caja de arena no puede escribir en ~/.claude/skills.

  • career_state.py paths|contributions|plan --home "$HOME": ubicaciones de archivos, el registro de contribuciones (unión de ubicaciones antiguas y nuevas) y el plan de migración.
  • map_schema.py check <map.json> --today YYYY-MM-DD: errores, secciones faltantes, secciones obsoletas (más de 90 días), conflictos.
  • deadlines.py --deadline YYYY-MM-DD --today YYYY-MM-DD [--dead START:END ...] [--published]: cuándo hablar con el gerente. --dead es opcional y repetible.

La forma del mapa está en reference/map-schema.md, y el diseño en markdown está en reference/map-template.md. Los demás archivos de estado compartido (registro de contribuciones, banderas, iniciativas) se describen en <plugin root>/lib/career/STATE.md; para limpiar una bandera ya gestionada, escriba flags.json de nuevo sin ella.

1. Cargar estado (cada ejecución)

  1. Ejecute career_state.py plan. Aplique cada acción write con la herramienta de escritura, leyendo primero el archivo de destino si ya existe (la herramienta de escritura no sobrescribirá un archivo que no haya leído). Una acción mkdir no necesita un paso aparte: la carpeta se crea al escribir el primer archivo dentro de ella. No escriba un mapa provisional. Nunca borre nada.
  2. Lea ~/.claude/skills/flagrare/config.json (claves de identidad de nivel superior, el bloque skills.promotion) y el mapa existente, si lo hay. Si falta el archivo de configuración o el bloque skills.promotion, continúe con los valores predeterminados.
  3. Si no hay mapa, es una primera ejecución (sección 3). Si la salida de map_schema.py check enumera secciones missing, es una primera ejecución interrumpida: reanúdela en la fase más temprana cuyas secciones falten. De lo contrario, ejecute una actualización (sección 4), a menos que el usuario solicite el modo packet (sección 5).

Invocado por /flagrare:career. Los argumentos nombran un modo (first_run, resume o refresh) y las secciones en las que trabajar: haga solo esas. Cuando además dicen scheduled, nunca entreviste ni pregunte: investigue de nuevo y guarde solo las secciones que no requieren respuesta del usuario (proceso, calendario, rúbrica, organización, precedente), y devuelva cada una que necesite al usuario (objetivo, personas, preguntas para el gerente) como una línea para la lista de Necesidades del coordinador. En cualquier caso, devuelva un resumen breve de lo que cambió en lugar del mapa completo.

2. Reglas para cada hecho

  • Fuente, fecha, estado. Cada hecho tiene un enlace o ubicación citada, la fecha en que lo verificó y un estado: verified (leído y citado textualmente de la fuente original), unverified (un resumen, fragmento o información de segunda mano) o inferred (su razonamiento).
  • Cite textualmente la fuente original. Las herramientas de obtención de datos resumen y parafrasean. Cuando se vaya a confiar en una cita, vuelva a leer la página original (por ejemplo, el JSON o HTML de la página) y confirme las palabras exactas.
  • Muestre conflictos, nunca elija en silencio. Cuando dos fuentes discrepen (un organigrama frente a un directorio de equipo, una página de proceso frente al archivo de la escalera), almacene ambas como alternatives e informe al usuario.
  • "No se encontró nada" es un resultado válido. Si un paso no encuentra nada, añada una pregunta concreta a manager_questions en lugar de adivinar. Muchas empresas no tienen un proceso escrito.
  • Los datos sobre personas son sensibles. Solo lea las interacciones del propio usuario. Registre quién tiene contexto de primera mano sobre el trabajo del usuario, nunca una clasificación de lo útiles que son las personas.
  • Pida consentimiento antes de usar el navegador en portales de RR. HH. o sitios internos.

3. Primera ejecución

Advierta al usuario desde el principio: la primera ejecución es larga, a menudo una hora o más, y guarda después de cada fase, por lo que se puede detener y reanudar.

Cada guardado escribe tanto promotion-map.json como promotion-map.md, y establece sections.<nombre>.checked_at (hoy) y sections.<nombre>.sources para cada sección escrita en esa fase. Una sección sin checked_at se considera obsoleta. La Fase 1 escribe target, process y calendar; la Fase 2 escribe rubric; la Fase 3 escribe org, people y precedent; la Fase 4 escribe packet_readiness y manager_questions. Escriba cada sección incluso cuando no se haya encontrado nada (una lista vacía u objeto con su checked_at), de modo que una sección vacía no se confunda con una ejecución interrumpida.

Fase 1: Objetivo, proceso y calendario

  1. Entreviste primero, antes de cualquier investigación. Haga una pregunta a la vez:
    1. Nivel actual y nivel objetivo.
    2. Trayectoria: contribuidor individual o gerente.
    3. ¿A qué ciclo apunta? (Vuelva a esto después del paso 4, una vez que conozca el calendario, y proponga uno).
    4. Por qué lo quiere, qué trabajo quiere más y qué quiere menos.
  2. Busque dos datos sobre el nivel objetivo: ¿es terminal en esta empresa (no se espera una promoción más allá de él)? y ¿cuál es la banda de tiempo esperada en el nivel actual? Cite ambos.
  3. Explique qué cambia el "por qué". Un objetivo terminal más un "por qué" de tranquilidad hacen del objetivo la meta final. Un "por qué" de dinero o alcance significa planificar más allá de él. Escriba esto en la sección 1 del mapa.
  4. Encuentre el proceso, el calendario y la plantilla del packet en cada fuente conectada: wiki, documentos, anuncios de chat, notas de reuniones, el portal de RR. HH. (con consentimiento). También encuentre cómo se toman las decisiones de producto: el documento de decisión y quién suele impulsarlo. Opportunity-scan necesita esto. También encuentre qué mide la dirección: los temas o documentos de estrategia de la empresa, OKR y documentos de planificación, y lo que dicen las reuniones de planificación y las reuniones generales (en notas de reuniones como Granola, cuando está conectado). Registre cada métrica que sea importante para el área del usuario en priorities: el tema, la métrica, su línea base y objetivo cuando estén escritos (cada uno un hecho con una fuente), el equipo que la posee, y user_lever: owner si el puesto del usuario posee la entrada principal de la métrica, input si sus sistemas la alimentan, none si la palanca está en otro equipo. Opportunity-scan clasifica las propuestas contra esta lista. Tome las prioridades de las notas de reuniones, nunca de citas sobre personas.
  5. Guarde el mapa (JSON y markdown) con las entradas target, process, calendar y sections completadas.

Fase 2: Brecha de rúbrica

  1. Encuentre el artefacto con el que los gerentes evalúan (una hoja de cálculo de escalera, un libro de trabajo de check-in), no la prosa escrita al respecto. Pregunte al usuario si su gerente usa un libro de trabajo de check-in. Si la prosa y el artefacto discrepan, use el artefacto y registre la discrepancia en rubric.prose_mismatches.
  2. Construya una entrada rubric.rows por comportamiento: el texto del nivel actual, el texto del nivel objetivo, un id estable (<area>.<short-slug>) y una label, el comportamiento en dos a cuatro palabras llanas ("Encontrar problemas", "Revisor buscado"), que el tablero y los resúmenes muestran en lugar del id.
  3. Marque cada fila como done, partial o not_started, con evidencia de career_state.py contributions, reconocimiento que los compañeros dieron al usuario (cuando una herramienta de reconocimiento está configurada, ver "Reconocimiento" más abajo: cada bonus con su enlace es una prueba, y el valor de la empresa con el que está etiquetado apunta al comportamiento de valores fundamentales), las reseñas y el trabajo del usuario, y las notas de reseñas anteriores que el usuario comparta.
  4. Guarde.

Fase 3: Organización y quién conoce tu trabajo

  1. Organización: la cadena del usuario, quién está por encima de cada equipo al que podría llegar, y los cambios próximos (salidas, nuevos líderes, reorganizaciones a partir de notas de reuniones y anuncios). Cada persona tiene una fuente y un estado.
  2. Quién conoce tu trabajo, evidencia primero, luego el usuario:
    • Proponga personas a partir de las interacciones del propio usuario (reseñas dadas y recibidas, hilos compartidos, reuniones compartidas y todos los que le dieron reconocimiento), cada una con enlaces de evidencia. Una persona que reconoció al usuario ha visto su trabajo de primera mano; marque a cualquiera de ellos que esté en el comité de promoción.
    • Pida al usuario que confirme y corrija, y que añada lo que ninguna herramienta puede ver, como un ex gerente o un equipo de hackathon.
    • Establezca seen_your_work y confirmed_by_user.
  3. Quién está en la calibración: infiéralo del documento de proceso, cite la frase y márquelo como inferred. Enumere las personas en la sala que no han visto el trabajo del usuario.
  4. Precedente: lea los anuncios de promoción recientes para ver qué se acreditó, y escriba "los anuncios son narrativas, no auditorías" en el mapa. Ofrezca el nivel profundo solo si el usuario lo solicita: verificación cruzada en código, documentos y tickets de quién originó realmente el trabajo. Es costoso y está desactivado por defecto.
  5. Guarde.

Fase 4: Plan

  1. Fechas límite: ejecute deadlines.py con la fecha límite del packet. Si la fecha de este ciclo está publicada, úsela y pase --published. De lo contrario, proyecte la fecha del año pasado en este ciclo (mismo mes y día, un año después) y déjela como inferred. Pregunte al usuario qué ventanas de vacaciones o días libres son tiempo muerto donde está, y páselas como --dead. Registre "cómodo antes de X, absoluto antes de Y" con su estado y condición. Si el estado es past, dígalo claramente y nombre el próximo ciclo.
  2. Un siguiente paso por fila abierta: para cada fila que no esté done, escriba next_step: la única acción concreta más barata que añadiría evidencia, adaptada a lo que encontró sobre la empresa ("escribe /interview en el canal de reclutamiento", "ofrece una sesión de emparejamiento en el panel del partner", "pide a tu gerente una parte de la hoja de ruta para co-liderar"). El tablero enumera las tres brechas más grandes con estos pasos, así que haga que cada uno se pueda hacer en una semana, no una meta.
  3. Preparación del packet: ejecute python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date> para obtener el recuento de evidencia de cada fila de rúbrica (entradas de registro etiquetadas con la fila más la evidencia de la propia fila), luego marque cada sección de la plantilla como strong, thin o empty según las filas de las que se basa.
  4. Selecciones de comentarios de compañeros: de recognition.py summary, las personas que más reconocieron al usuario y por qué son los primeros candidatos para los comentarios de compañeros del caso escrito (de 3 a 5); añádalos a la nota de Comentarios de Compañeros.
  5. Preguntas para el gerente: todo lo que aún se desconoce, más la pregunta sobre la preparación ("¿es realista , y qué falta?").
  6. Ejecute map_schema.py check. Corrija cualquier error, luego guarde.
  7. Muestre al usuario un resumen breve: el objetivo, las dos fechas de conversación, los comportamientos de Senior aún no mostrados (por etiqueta), quién aún necesita ver su trabajo y las preguntas para su gerente. Señale promotion-map.md.

4. Actualización

  1. Ejecute map_schema.py check, y lea career/flags.json si existe (otras habilidades escriben allí señales de obsolescencia, como una reorganización, una salida o un calendario publicado). Actualice el reconocimiento con python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> (aplique su escritura planificada de career/recognition.json con la herramienta de escritura; necesita red) cuando una herramienta de reconocimiento esté configurada.
  2. Re-investigue solo las secciones obsoletas o marcadas. Mantenga todas las demás secciones como están.
  3. Pregunte al usuario "¿algo cambió?", cubriendo objetivo, gerente, equipo y las personas que han visto su trabajo.
  4. Si la sección de calendario se vuelve a verificar, o una bandera dice que el calendario se publicó, vuelva a ejecutar deadlines.py y actualice calendar.manager_conversation.
  5. Actualice el next_step de cada fila abierta cuando la evidencia para ella haya cambiado (un paso que está hecho o ya no es el más barato se reemplaza), y añada cualquier label faltante.
  6. Actualice checked_at para cada sección re-verificada, limpie las banderas que gestionó y guarde.

Reconocimiento

Cuando la empresa del usuario usa una herramienta de reconocimiento entre pares (hoy en día Bonusly), sus agradecimientos son prueba de que el usuario no tuvo que registrarlo. Configuración: el usuario crea un token de API personal en la herramienta y lo guarda en ~/.config/flagrare/bonusly-token (o el archivo nombrado por skills.career.recognition.token_file en config.json). Nunca almacene el token en config.json o un repositorio, y nunca lo pegue en el chat. Luego ejecute python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> (aplique su escritura planificada de career/recognition.json con la herramienta de escritura; necesita red); recognition.py summary da totales, valores de la empresa y quién reconoció más al usuario; los agradecimientos de las cuentas automáticas de la herramienta (cumpleaños, aniversarios, bienvenidas) se cuentan por separado y nunca se tratan como personas ni pruebas. Cite solo lo que se dice sobre el usuario. Nunca se envía nada a través de la herramienta.

5. Modo packte (/flagrare:promotion packet)

Cuando se acerque la fecha límite del packet, o el usuario lo solicite:

  1. Cargue el mapa; si no hay ninguno, primero ejecute la primera ejecución. Reúna evidencia desde la fecha de la última promoción (o la fecha de contratación): use /flagrare:brag-doc para ventanas de hasta un mes y /flagrare:impact-timeline para ventanas más largas.
  2. Redacte el packet en la plantilla de la empresa, a partir de process.packet_template (si se desconoce la plantilla, use esta forma común y diga que es un respaldo: los campos de encabezado, luego 2-3 proyectos (rol, estimación...).

El contenido ha sido truncado; para la versión completa consulte la SKILL.md original.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados