Communitygithub.com

cucoreanu/personal-skills

Apenas para o agente. Após o usuário pedir para criar um PR para uma habilidade nova ou atualizada em skills/ (nunca esta), verifica a instalação do projeto em relação ao código fonte com scripts/diff-install.mjs; se estiver faltando ou desatualizada, pergunta para instalar localmente via links simbólicos relativos. Use ao criar ou modificar habilidades neste repositório, abrir um PR de habilidade ou finalizar o trabalho em uma habilidade.

O que é personal-skills?

Esta habilidade (skill) é uma ferramenta exclusiva para agentes de IA, projetada para gerenciar a instalação local de outras skills dentro do repositório de skills pessoais `cucoreanu/personal-skills`. Ela não é destinada ao usuário final e não deve ser oferecida como um comando de barra. O principal objetivo é garantir que, ao criar ou modificar uma skill (exceto ela mesma) e abrir um Pull Request, a skill recém-criada ou atualizada seja instalada localmente via links simbólicos relativos nos diretórios `.agents/skills/` e `.claude/skills/`, em vez de ser copiada. Para isso, o agente executa um script (`diff-install.mjs`) que compara a instalação atual com o código fonte. Se a skill estiver faltando, desatualizada ou com um link incorreto, o agente pergunta ao usuário se deseja instalá-la. Após confirmação, um script de instalação (`install.mjs`) cria os links simbólicos necessários. Esta abordagem garante que Cloud Agents e outras ferramentas sempre utilizem a versão mais recente da skill no repositório, sem duplicação de arquivos. A habilidade é compatível com repositórios que usam a estrutura padrão de skills para Claude Code, Cursor, Codex ou plataformas similares que suportam o diretório `.agents/skills/` e `.claude/skills/`.

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

Perguntar na sua IA favorita

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

Documentação

Instalar skill local

Não é um comando de usuário. Não ofereça como uma skill de barra. Nunca aplique este fluxo de trabalho a esta skill (install-local-skill).

Quando

Execute após o usuário ter solicitado a criação de um PR (ou você estiver criando esse PR), e apenas se nesta interação foi criada ou atualizada uma skill em skills/<nome>/ que não seja install-local-skill.

Ignorar completamente quando:

  • A única skill tocada for install-local-skill
  • O usuário nunca pediu um PR e você não está abrindo um
  • O contexto já mostra que a skill foi lançada e a instalação local corresponde ao código fonte (veja adiar)

Adiar (não perguntar ainda)

Se não estiver claro se a skill foi lançada, ou se um PR está em andamento, verifique a instalação primeiro — não pergunte até saber que está faltando ou desatualizada.

A partir da raiz do repositório:

node skills/install-local-skill/scripts/diff-install.mjs --skill <nome>

Omita --skill para verificar todas as skills criadas, exceto esta.

Caminho rápido: se .agents/skills/<nome> e .claude/skills/<nome> já resolverem para o mesmo caminho real que skills/<nome>, o status é ok — não pergunte. Execute o diff de árvore apenas quando a instalação não for esse layout de link simbólico.

Pergunte apenas quando needsInstall não estiver vazio (ou o status da skill for missing, stale ou wrong-link).

Perguntar

Pergunte uma vez, nomeando a(s) skill(s):

Instalar <nome> localmente neste repositório (link simbólico .agents / .claude para skills/) para que Cloud Agents e outras ferramentas o reconheçam?

Não instale em caso de silêncio. Prossiga apenas com um "sim" explícito.

Instalar (mesma técnica deste repositório)

Não use npx skills add (ele copia para .agents/skills/). Após o "sim":

node skills/install-local-skill/scripts/install.mjs <nome>

Isso substitui a instalação do projeto por links simbólicos relativos:

  • .agents/skills/<nome> → ../../skills/<nome>
  • .claude/skills/<nome> → ../../.agents/skills/<nome>

Em seguida, execute novamente diff-install.mjs --skill <nome> e confirme que o status é ok. Adicione os novos links simbólicos ao PR quando eles pertencerem ao git.

Não fazer

  • Perguntar enquanto ainda está apenas rascunhando a skill, antes de um PR ser solicitado
  • Instalar install-local-skill por meio deste fluxo de trabalho
  • Instalações globais (-g)
  • Copiar árvores para .agents/skills/ ou .claude/skills/

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

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.

cucoreanu/personal-skills

Proofreads messages and teaches reusable writing patterns. Use when the user pastes a work message, Slack draft, status update, or asks for proofreading, tone, clarity, grammar, flow, or constructive feedback on writing they will send at work.

Habilidades Relacionadas