Communitygithub.com

FerroxLabs/murage

Constrói um documento formal de defesa de promoção com realizações e métricas, evidências de escopo expandido, impacto em pares e partes interessadas, contexto de mercado e um pedido claro. Produz um documento compartilhável que o usuário pode apresentar ao seu gerente ou liderança.

O que é murage?

Esta skill, FerroxLabs/murage, é um assistente especializado para engenheiros e profissionais de tecnologia que desejam construir um documento de defesa de promoção bem estruturado e baseado em evidências. Diferente de ferramentas de autoavaliação ou negociação salarial, seu foco é exclusivamente na criação de um documento formal e compartilhável para apresentar a gerentes ou comitês de revisão. A skill orienta o usuário através de um processo de 8 etapas detalhado, começando com a coleta do contexto organizacional (níveis, processo de promoção, objeções conhecidas) e a construção de um inventário de realizações quantificáveis. Em seguida, ajuda a mapear evidências de escopo expandido, coletar depoimentos de pares e stakeholders, e construir uma seção de contexto de mercado. O resultado é um rascunho completo que inclui um resumo executivo conciso, um pedido claro de título, data e compensação, e um plano de ação. A skill suporta os principais processos de promoção do mercado de tecnologia (ciclos formais, indicação do gerente, autonomeação) e se baseia em documentação como guias de carreira (leveling guides) e feedback de colegas. Ela é comum para níveis de IC sênior e gerentes, especialmente em empresas de tecnologia, consultorias e serviços financeiros.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FerroxLabs/murage/tree/HEAD/skills-library/promotion-case-builder

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construtor de Caso de Promoção

Quando Usar

Use esta skill quando o usuário explicitamente desejar construir um documento escrito e compartilhável que defenda uma promoção — e não quando ele quiser coaching, um roteiro de conversa ou conselho de carreira geral.

Cenários de acionamento:

  • O usuário diz que quer preparar um pacote de promoção, caso de promoção ou documento de promoção para enviar ao seu gerente ou a um comitê de revisão
  • O usuário pergunta como documentar suas realizações para justificar um pedido de aumento de nível em um ciclo de revisão futuro
  • O usuário já foi informalmente informado de que está no caminho da promoção e precisa formalizar as evidências
  • O usuário está se preparando para uma reunião de calibração de promoção onde seu gerente defenderá seu caso para um comitê e precisa de material de apoio
  • O usuário quer construir proativamente o caso antes da abertura de um ciclo formal para estar pronto para enviar imediatamente
  • O usuário foi preterido em uma promoção em um ciclo anterior e quer construir um caso mais forte e estruturado para o próximo
  • A empresa do usuário exige um pacote de promoção de autoria própria como parte do processo formal (comum em níveis de IC sênior e gerentes em empresas de tecnologia, consultorias e serviços financeiros)
  • O usuário quer documentar um padrão de atuação acima do seu nível atual para construir o argumento de timing — que a promoção está atrasada, não é aspiracional

NÃO use quando:

  • O usuário quer escrever uma autoavaliação de desempenho que será submetida como parte de um ciclo de revisão anual — use performance-review-prep em vez disso, que estrutura o conteúdo em torno de rubricas de revisão, não critérios de promoção
  • O usuário quer um roteiro, pontos de discussão ou coaching para uma conversa de promoção presencial — use salary-negotiation-script para o componente de discussão de remuneração
  • O usuário precisa de ajuda para escrever ou reescrever bullets de currículo para refletir realizações — use resume-bullet-writer, que aplica formatação de verbo de ação e STAR para um público de currículo, não um documento de defesa interno
  • O usuário está perguntando se merece uma promoção ou quer que você avalie sua prontidão — esta skill constrói o documento, não dá um veredito
  • O usuário está escrevendo uma nomeação ou recomendação para a promoção de outra pessoa — esta skill produz um documento de autodefesa em primeira pessoa
  • O usuário precisa de um plano de 30-60-90 dias para uma função que está prestes a entrar — isso é planejamento de onboarding, não construção de caso de promoção

Processo

Etapa 1: Coletar o Contexto da Promoção Antes de Escrever Qualquer Coisa

A qualidade do caso de promoção depende inteiramente da compreensão do contexto organizacional. Faça todas essas perguntas antes de redigir uma única linha do documento.

  • Cargo e nível atual e desejado: Obtenha os títulos exatos. "Sênior" e "Staff" significam coisas diferentes em empresas diferentes. Se a empresa usa níveis numéricos (L4, L5, E5, Banda 6), capture tanto o título quanto o código do nível, pois os guias de nivelamento são indexados por códigos, não por títulos.
  • Tempo no cargo atual: Isso é importante por duas razões — determina se o caso precisa abordar preocupações de tempo de casa (menos de 12 meses é um obstáculo; 12-24 meses é padrão; 36+ meses pode exigir abordar por que a promoção ainda não aconteceu) e define a janela de evidências.
  • Tipo de processo de promoção: Existem quatro arquétipos comuns. (1) Ciclo formal com calibração de comitê — comum em empresas de tecnologia, bancos e consultorias; o documento será lido por pessoas que não conhecem o usuário. (2) Iniciado pelo gerente com aprovação de RH — o documento é para o gerente usar como material de defesa interno. (3) Autonomeação com pacote de revisão de pares — o usuário submete diretamente; o documento deve ser autossuficiente. (4) Sob demanda ou baseado em conversa — sem processo formal; o documento se torna um resumo ou um anexo de e-mail estruturado.
  • Disponibilidade do guia de nivelamento: Se a empresa publica uma carreira ou estrutura de nivelamento, obtenha os critérios específicos tanto para o nível atual quanto para o desejado. O caso deve mapear as evidências para esses critérios exatos, não para competências genéricas. Se não existir guia, pergunte ao usuário quais comportamentos ou expectativas ele ouviu associados ao nível desejado.
  • Postura do gerente: Apoiadora (o gerente já está defendendo, precisa de munição), neutra (o gerente está aberto mas não convencido) ou cética (o gerente tem reservas ou deu sinais mistos). Isso determina o enquadramento — gerentes céticos exigem que o caso aborde preventivamente as objeções.
  • Objeções conhecidas: Pergunte diretamente ao usuário: "Seu gerente ou alguém mais levantou alguma preocupação sobre sua prontidão?" Objeções comuns incluem tempo de casa muito curto, escopo muito estreito, questões de profundidade técnica versus amplitude, ou comparações com pares. Cada objeção conhecida deve ser abordada diretamente no documento.
  • Resultado do ciclo de revisão anterior: Se o usuário foi preterido antes, pergunte qual feedback recebeu. O novo caso deve mostrar como ele abordou esse feedback específico.

Etapa 2: Construir o Inventário de Realizações

Este é o núcleo probatório do documento. Não aceite descrições vagas.

  • Busque de 5 a 8 realizações. Menos de 5 parece fraco. Mais de 8 dilui as evidências mais fortes e torna o documento pesado para um revisor ocupado.
  • Para cada realização, exija quatro elementos: (1) a ação tomada — o que especificamente o usuário fez, não o time, (2) o resultado — o que mudou como consequência, (3) a métrica — um número, porcentagem, delta de tempo ou valor em dinheiro, e (4) o mapeamento de nível — qual competência no nível desejado essa evidência satisfaz.
  • Pressione pela quantificação. Se o usuário disser "Eu melhorei a satisfação do cliente", pergunte: Em quantos pontos de NPS? Qual era o CSAT antes e depois? Quantos clientes foram afetados? Qual era a taxa de churn antes versus depois? Se o usuário realmente não puder produzir um número, use um enquadramento de escopo-consequência: "Melhorei o fluxo de onboarding para 8.000 novos usuários mensais, reduzindo a principal categoria de escalonamento de suporte ao eliminar os três principais pontos de atrito identificados na pesquisa de usuários."
  • Ordene as realizações por magnitude de impacto, não cronologicamente. A realização mais crítica para o negócio vai primeiro. Se o usuário liderou um projeto que gerou US$ 500 mil em receita, essa é a âncora; se ele também reduziu o tempo de uma reunião, isso não é a realização nº 2.
  • Distinga entre entregas (o que foi entregue) e resultados (o que mudou por causa da entrega). Comitês e gerentes em reuniões de calibração se importam com resultados. "Entreguei o novo recurso de busca" é uma entrega. "Entreguei o novo recurso de busca que aumentou a conversão de busca para compra em 18%, contribuindo com US$ 1,2 milhão em receita incremental trimestral" é um resultado.
  • Identifique quais realizações demonstram trabalho que os pares do usuário no nível atual NÃO estão fazendo. Esses são os sinais de "acima do nível" que os comitês procuram. Um SE II que liderou uma migração entre equipes está fazendo trabalho de SE III; um SE II que entregou recursos no prazo está fazendo bem o trabalho de SE II.

Etapa 3: Construir a Evidência de Escopo Expandido

Promoção não é uma recompensa por fazer bem o trabalho atual — é o reconhecimento de que você já está atuando no próximo nível. Esta seção deve provar essa afirmação.

  • Mapeie as responsabilidades diárias atuais do usuário contra a descrição do cargo ou os critérios de nivelamento TANTO para o nível atual quanto para o desejado. Qualquer coisa que ele esteja fazendo que apareça na descrição do nível desejado, mas não na do nível atual, é evidência de escopo expandido.
  • Identifique padrões de propriedade: Quem procura o usuário para decisões? Quem o trata como o proprietário de facto de um sistema, domínio ou processo? Quanto mais pessoas seniores direcionam perguntas ao usuário para áreas que não são formalmente dele, mais forte é o sinal de escopo.
  • Documente a influência multifuncional: O usuário alinhou dois times que estavam em conflito? Ele representou seu time em um fórum de liderança? Ele produziu um documento, padrão ou processo que outros times adotaram? Esses são multiplicadores de escopo.
  • Para alvos de gestão de pessoas (engenheiro de gerência, diretor, líder de time): Documente cada instância de comportamento de gestão de facto — liderar reuniões de time, realizar 1:1s com funcionários juniores, escrever feedback de desempenho, resolver conflitos no time. Esses comportamentos na ausência do título formal são as evidências mais fortes possíveis.
  • Use o "teste de vacância" para enquadrar o escopo: "Se essa pessoa saísse amanhã, o que quebraria ou pararia que ninguém no nível atual seria esperado consertar?" A resposta é o escopo de próximo nível.

Etapa 4: Coletar Evidências de Impacto em Pares e Partes Interessadas

Um caso de promoção apoiado apenas pelas próprias afirmações do usuário é mais fraco do que um que inclui validação externa. Esta seção transforma a autodefesa em defesa corroborada.

  • Peça ao usuário para se lembrar de instâncias específicas de feedback positivo por escrito — mensagens do Slack, e-mails, comentários de avaliação de desempenho de pares, trechos de feedback 360, nomeações para prêmios, menções em revisões trimestrais de negócios. Essas citações são poderosas porque vêm de terceiros.
  • Identifique a pessoa de maior status que elogiou ou dependeu do trabalho do usuário. Um VP que citou a análise do usuário em uma apresentação para o conselho é mais persuasivo do que um par que agradeceu.
  • Documente o raio de alcance do trabalho do usuário: quantas pessoas, times ou clientes foram afetados. "Meu trabalho impactou 3 equipes de engenharia e 40.000 usuários finais" é mais convincente do que "Contribuí para a plataforma."
  • Para mentoria: documente resultados, não atividades. "Mentorei dois engenheiros" é uma atividade. "Mentorei dois engenheiros que agora ambos operam de forma autônoma e um deles foi promovido a SE II no último trimestre" é um resultado com evidências.
  • Se o usuário não tiver feedback escrito para citar, aconselhe-o a coletar feedback proativamente antes de enviar o caso de promoção. Uma solicitação direcionada — "Estou montando um pacote de promoção e gostaria muito de uma breve nota sobre nosso trabalho juntos" — enviada para dois ou três colegas de confiança leva 24 horas para ser executada e fortalece substancialmente o documento.

Etapa 5: Construir a Seção de Contexto de Mercado

Esta seção estabelece que a promoção não é apenas justa para o usuário — é a decisão de negócio correta para a empresa e é consistente com as normas de mercado.

  • Enquadre o contexto de mercado em três camadas: (1) Normas de título — em empresas comparáveis, quais responsabilidades o título desejado carrega? As responsabilidades atuais do usuário devem corresponder ou exceder essas normas. (2) Benchmarks de remuneração — qual é a faixa salarial para o nível desejado? Faixas gerais derivadas de dados do Levels.fyi para engenheiros, Glassdoor para gerentes, LinkedIn Salary para generalistas, ou pesquisas de remuneração da indústria (Radford, Mercer) são referências apropriadas. Use faixas de US$ 5.000 a US$ 10.000, não estimativas pontuais. (3) Risco de retenção — qual é o custo para a empresa da saída e substituição do usuário? Uma regra geral para contribuidores individuais de nível médio é de 50 a 200% do salário anual em custos de recrutamento, onboarding e perda de produtividade. Não invente um número específico; use a faixa.
  • Para funções especializadas (engenheiros de segurança, engenheiros de ML, gerentes de produto em growth), observe que o mercado para o nível desejado é ativo e competitivo, porque isso cria urgência sem ser ameaçador.
  • Calibre quão proeminentemente apresentar a remuneração no pedido com base na leitura do usuário da cultura da empresa. Em empresas com faixas salariais transparentes, citar a faixa é normal. Em empresas onde a remuneração é opaca, levantar números específicos no documento de promoção pode sair pela culatra; uma referência mais suave a "remuneração alinhada com a faixa do nível desejado" é mais segura.
  • Se o usuário recebeu uma oferta concorrente ou interesse de recrutador externo, ele deve decidir separadamente se usará isso como alavanca. NÃO inclua uma oferta concorrente em um documento de promoção formal — ela pertence a uma conversa de negociação, não a um documento de calibração.

Etapa 6: Redigir o Resumo Executivo

Escreva isso por último, não primeiro, mesmo que apareça primeiro no documento.

  • O resumo executivo é o que o gerente lerá em voz alta para um comitê de calibração. Deve ter três frases ou menos. Cada palavra é essencial.
  • Estrutura: Frase 1 — tempo de casa e o impacto mais impressionante e único. Frase 2 — o padrão de atuação acima do nível (o argumento de escopo). Frase 3 — o pedido explícito de prontidão para promoção.
  • Evite: jargões ("sinergizado", "alavancado", "conduziu alinhamento"), adjetivos sem evidência ("excepcional", "notável") e enquadramento em tempo futuro ("Estou pronto para assumir"). O resumo deve ser inteiramente em tempo presente e passado — o que foi feito e o que está acontecendo atualmente.
  • Teste o resumo executivo com esta pergunta: Um membro do comitê que nunca conheceu o usuário conseguiria ler este resumo de três frases e ter informações suficientes para entender por que esta promoção é justificada? Se sim, está bom. Se eles precisarem de contexto para entender qualquer termo ou afirmação, revise.

Etapa 7: Escrever o Pedido e o Próximo Passo Proposto

O pedido é onde muitos documentos de promoção falham — eles fazem um caso forte e depois desaparecem sem uma solicitação clara e específica.

  • Declare o título exato sendo solicitado. Não escreva "uma promoção" — escreva "promoção de Analista Sênior para Analista Principal."
  • Declare a data de vigência proposta. Opções: próximo ciclo de revisão (nomeie o mês/trimestre), uma data específica de 30 a 60 dias para processos sob demanda, ou "mediante aprovação do comitê na calibração do [nome do ciclo]."
  • Declare a expectativa de remuneração claramente, mas calibre-a para a cultura. No mínimo: "Remuneração alinhada com a faixa de [título desejado]." Se o usuário souber a faixa: "Salário base na faixa de US$ [X]-US$ [X], consistente com a faixa salarial de [título desejado]."
  • Proponha um acompanhamento específico: uma reunião de 30 minutos com o gerente para discutir o caso e entender o que, se algo, precisaria ser verdade para que a promoção prossiga. Ofereça sempre uma data específica da...

[Nota do tradutor: O conteúdo original foi truncado no prompt. A tradução segue até onde foi fornecido, mantendo a estrutura e omitindo a seção de exemplo.]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

FerroxLabs/murage

Web animation expertise covering CSS animations and transitions, Web Animations API, Framer Motion, GSAP, scroll-driven animations, layout animations, spring physics, reduce-motion preferences, and performance budgets. Use when the user asks about animation designer, animation designer best practices, or needs guidance on animation designer implementation. Do NOT use when the user needs a different specialized skill or is asking about an unrelated technology domain.

FerroxLabs/murage

Writes board-level narrative updates that complement financial reports with strategic context, competitive positioning, key risks, and forward-looking guidance for board of directors audiences. Use when the user needs to write a board update, board meeting narrative, or director-level briefing. Do NOT use for stakeholder updates to management (use `stakeholder-update`), investor emails (use `investor-update-email`), or full business reports (use `business-report`).

FerroxLabs/murage

>- End-to-end workflow for building a professional photography portfolio from niche selection through shooting, editing, website creation, and client acquisition. Covers gear decisions, shooting technique, post-processing workflow, portfolio curation, online presence, and the transition from hobbyist to working photographer. Use when the user wants to build photography portfolio or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

>- End-to-end workflow for creating a high-converting SaaS landing page from copywriting through design, development, SEO optimization, and analytics setup. Covers persuasion frameworks, responsive design, performance optimization, and conversion tracking to turn visitors into customers. Use when the user wants to build saas landing page or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Calculates startup burn rate (gross and net), projects cash runway in months, and builds scenario analysis for different spending and revenue trajectories. Use when the user asks about burn rate, cash runway, how long their money will last, or startup cash management. Do NOT use for personal savings calculations (use budget-planning), full financial modeling (use financial-model-structure), or fundraising narrative (use fundraising-narrative).

FerroxLabs/murage

The user is asking \"how long do we have,\" \"can we afford this hire,\" or \"are we running out.\" Load whenever cash, burn, or time-to-zero shows up — or when a spending decision is on the table and the user doesn't know how many months it costs.

FerroxLabs/murage

Professional corporate video production guidance covering training videos, promotional content, testimonials, and product demos. Includes client brief templates, script approval workflows, achieving professional quality on budget, brand compliance, stakeholder management, and delivery specifications. Use when the user asks about corporate video or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Helps artists, designers, and creative professionals curate, organize, and present their work through compelling portfolios across digital platforms, personal websites, and print formats for career advancement. Use when the user asks about creative portfolio builder, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio builder or requires a different specialized skill.

FerroxLabs/murage

Cross-discipline creative portfolio assessment evaluating artistic cohesion, technical skill, presentation quality, and market positioning. Produces a scored evaluation with recommendations for strengthening creative identity and professional opportunity. Use when the user asks about creative portfolio evaluator, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio evaluator or requires a different specialized skill.

FerroxLabs/murage

Professional design portfolio evaluation assessing design process, craft quality, range of work, presentation, and industry alignment. Produces a scored review with recommendations for strengthening design practice and career positioning. Use when the user asks about design portfolio reviewer, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of design portfolio reviewer or requires a different specialized skill.

FerroxLabs/murage

Teaches specific named emotional regulation techniques (the STOP technique, urge surfing, cognitive reframing, emotional labeling, opposite action, and physiological soothing) with step-by-step sequences. Gathers the user's emotional challenges and triggers, then produces a personalized regulation toolkit with technique instructions and a situation-response plan. Use when the user asks about managing emotions, controlling anger, handling frustration, emotional regulation strategies, or building emotional resilience. Do NOT use for clinical emotional dysregulation treatment, personality disorder management, or replacing professional mental health support.

FerroxLabs/murage

Structures a fundraising narrative for startup investors covering traction, market size, business model, use of funds, and milestone targets using standard VC pitch structure. Use when the user asks about fundraising pitch, investor narrative, raising capital, pitch deck story, or investment memo. Do NOT use for sales pitch decks (use sales-pitch-deck), personal loan applications, grant proposals (use grant-proposal-writing), or financial model creation (use financial-model-structure).

FerroxLabs/murage

Interactive storytelling for games covering branching narratives, dialogue trees, environmental storytelling, lore design, character writing for games, quest design, player agency, world-building for interactive media, and narrative integration with game mechanics. Use when the user asks about game narrative writer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Writes Instagram captions with a hook line, story body, hashtag strategy, and platform-optimized call-to-action. Use when the user wants to write an Instagram caption, create Instagram content, or draft text to accompany an Instagram post or reel. Do NOT use for LinkedIn posts (use `linkedin-post`), Twitter threads (use `twitter-thread`), or blog posts (use `blog-post-writing`).

FerroxLabs/murage

Produces conversion-optimized landing page copy with hero section, problem statement, solution, social proof, and CTA sections using conversion copywriting methodology. Use when the user asks to write landing page copy, create a product page, write a sales page, draft conversion copy, or write landing page text for a website. Also useful when asked to write website copy or create a page that converts visitors. Do NOT use for ad copy (use paid-ad-copy), product descriptions for e-commerce listings (use product-description), or full website content strategy (use seo-content-strategy).

FerroxLabs/murage

Guides the user through launching a professional art or creative portfolio from curation through outreach, chaining 5 atomic skills across career-development, design-creative, and writing categories. Covers physical vs. digital portfolio, platform selection, fine art vs. commercial positioning, and curated vs. comprehensive approaches. Use when the user wants to create and launch a portfolio to attract clients, galleries, or employers. Do NOT use for building a job search portfolio in non-creative fields (use land-new-job workflow), personal brand content strategy (use build-personal-brand workflow), or creating the artwork itself.

FerroxLabs/murage

>- Complete YouTube channel launch workflow from niche selection and channel strategy through video production, editing, monetization setup, community building, and personal brand development for sustainable channel growth. Use when the user wants to launch youtube channel or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Run a section-by-section conversion teardown of one landing page — hero, value proposition, social proof, features, objection handling, CTA and footer — plus form, mobile and page-speed audits, ending in prioritised fixes split into quick wins, strategic and long-term, with A/B test hypotheses. Use when one page has traffic and is not converting. Do NOT use for a whole-site marketing audit (use market-audit), for the copy voice and awareness-stage decisions behind it (use copy-awareness-stages) or for the visual system it should sit inside (use mira-visual-system).

FerroxLabs/murage

Comprehensive motion graphics guidance covering title design, lower thirds, animated explainers, kinetic typography, logo animation, After Effects and Apple Motion workflows, design principles for motion, storyboarding for motion, and building a motion design practice. Use when the user asks about motion graphics or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Comprehensive animation guidance covering the 12 principles of animation, 2D and 3D production pipelines, tools (Blender, After Effects, Procreate, Toon Boom), frame rates, rigging, motion graphics vs character animation, and building an animation practice from concept to final render. Use when the user asks about animation creator or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

Habilidades Relacionadas