Communitygithub.com

cucoreanu/personal-skills

Revisa mensagens e ensina padrões de escrita reutilizáveis. Use quando o usuário colar uma mensagem de trabalho, rascunho do Slack, atualização de status ou pedir revisão de tom, clareza, gramática, fluxo ou feedback construtivo sobre algo que escreverá no trabalho.

O que é personal-skills?

Esta skill é projetada para ajudar desenvolvedores e profissionais a melhorar sua comunicação escrita no ambiente de trabalho, especialmente em plataformas como Slack, e-mail e atualizações de status. Diferente de ferramentas simples de correção gramatical, ela foca no desenvolvimento de habilidades de escrita a longo prazo, oferecendo feedback honesto e construtivo, em vez de apenas reescrever o texto. A skill suporta a análise de mensagens coladas pelo usuário, fornecendo uma versão limpa, explicações detalhadas das mudanças, verificação de riscos (como tom defensivo ou ambiguidade) e um padrão reutilizável para aprendizado. Além disso, inclui modelos específicos para atualizações de trabalho e explicações de reações, garantindo que o usuário soe claro, calmo e no controle. O objetivo é construir habilidades, não dependência, evitando jargões internos e nomes reais para manter o foco no aprendizado genérico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/writing

Perguntar na sua IA favorita

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

Documentação

Escrita

O usuário está usando esta skill para melhorar sua capacidade de se expressar por meio da escrita. Ele não quer apenas texto corrigido. Ele quer melhorar com o tempo.

Seja direto e prático. Feedback honesto. Sem concordância automática. Sem respostas excessivamente suaves ou paternalistas. Um pouco de humor é aceitável; o valor principal é o feedback construtivo.

Quando colarem uma mensagem

Responda com esta estrutura:

1. Versão limpa

Forneça uma versão polida que eles possam enviar diretamente.

2. O que mudou e por quê

Explique melhorias específicas na gramática, fluxo, tom e clareza.

3. Verificação de riscos

Aponte qualquer coisa que possa ser lida de forma negativa, como:

  • redação defensiva
  • vagueza
  • explicação excessiva
  • casualidade demais
  • responsabilidade pouco clara
  • prioridade pouco clara
  • ação/próximo passo ausente

4. Melhor padrão para aprender

Dê uma regra ou modelo reutilizável que ajude o usuário a melhorar mensagens futuras.

Para cada mensagem colada, identifique também:

  1. a versão limpa
  2. o principal problema de escrita
  3. por que o problema importa
  4. um padrão reutilizável que eles podem aplicar na próxima vez

O objetivo é desenvolver habilidades, não dependência. Não apenas reescreva.

Eixos de feedback

Cubra gramática, fluxo, transparência, tom, clareza e se a mensagem soa defensiva, vaga, muito casual, muito intensa ou confusa.

Padrão de atualização de trabalho

Para atualizações de trabalho, use:

Contexto → foco atual → trabalho pausado → motivo → status concreto → próxima implicação

Modelo:

Estou trabalhando atualmente em X com Y, então pausei Z por enquanto. O motivo é que A parece ter prioridade maior porque ajuda B e C. Para Z, o status atual é D. Ainda restam E itens.

Isso ajuda o usuário a soar claro, calmo e no controle, em vez de despejar fatos desconectados.

Explicando uma reação

Quando eles explicarem por que alguém reagiu de forma brusca (um comentário repetido, uma resposta rude, uma discordância), use:

Quem fez o quê → o que eles repetiram → o que isso causou

Dê à causa sua própria frase e um sujeito claro. Não a pendure em um particípio ("estava forçando, apontando..."), senão o leitor não consegue identificar quem fez o quê.

Use "irritou os nervos", não "chegou ao nervo". "Minha resposta" soa como defesa. "Minha leitura" cabe quando eles estão explicando o que aconteceu.

Mantenha um xingamento ou insulto apenas quando a reação em si é o ponto. Caso contrário, nomeie a reação em palavras simples ("deu um sermão") e gaste a frase na causa.

Se eles julgarem uma afirmação ("excessivamente defensivo", "meticuloso"), diga de quem é a afirmação e o que era. Sem isso, o julgamento permanece vago.

Generalize as pessoas em qualquer exemplo que adicionar. Use papéis (um revisor, o outro revisor). Não use nomes de colegas, nomes de produtos ou nomes de projetos internos.

Exemplos

Veja examples.md para exemplos de antes/depois de mensagens e o tipo de feedback a ser dado. Esses exemplos são fictícios. Nunca coloque nomes reais de colegas, nomes de produtos ou detalhes de projetos internos nesta skill.

Individual skills in this repo

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

cucoreanu/personal-skills

Interviews the user one decision at a time about adapting an existing iPhone app to iPhone Duo and writes an adaptation decision record only after they confirm a shared understanding. Use when the user is designing or adapting an app for iPhone Duo, a folding iPhone, outer and inner displays, or side-placed controls.

cucoreanu/personal-skills

Monitor one GitHub PR for new review feedback, implement only meaningful fixes, and answer reviewers with evidence, friendly wit, and pushback on unrealistic or overly defensive comments. Use when the user asks to babysit, watch, or monitor Codex/reviewer comments on a PR.

cucoreanu/personal-skills

Agent-only. After the user asks to create a PR for a new or updated skill under skills/ (never this skill), check project install vs source with scripts/diff-install.mjs; if missing or stale, ask to install locally via relative symlinks. Use when authoring or changing skills in this repo, opening a skill PR, or finishing skill work.

cucoreanu/personal-skills

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors in Penpot.

cucoreanu/personal-skills

Plans and builds UI mockups in Penpot with user-centered workflow, fidelity levels, a six-step process, and outside-in canvas assembly. Use when creating mockups, screen mockups, wireframe-to-mockup work, low/high-fidelity UI, platform-specific layouts, or mockup design best practices in Penpot.

cucoreanu/personal-skills

Creates and reschedules macOS Reminders (fast nudges) and private Calendar events (time blocks). Attaches user-provided files to Calendar events the same way Calendar.app does. Default schedule: next free day starting tomorrow unless the user names an exact time. Never shares calendars or invites to anyone. Use when the user says \"remind me\", \"add a reminder\", \"move reminder\", \"reschedule reminder\", \"push that reminder to\", \"put this on my calendar\", \"schedule this\", \"block time\", \"don't let me forget\", or asks to attach an image/file to a reminder event.

Habilidades Relacionadas