Minha visão subjetiva sobre código habitável, tanto para humanos quanto para IA. Destilado da experiência pessoal e da sabedoria coletiva de profissionais que confio. Empacotado como uma Habilidade de Agente que permite que agentes de codificação forneçam comentários narrativos e melhorias de design estrutural para código gerado por IA.
Esta skill, jasim/legible-code, encapsula uma filosofia de design de código focada em legibilidade e manutenibilidade, destinada a ser usada por agentes de IA (como Claude Code, Cursor ou Codex) durante a geração ou revisão de código. Ela oferece um conjunto de princípios práticos, extraídos da experiência do autor e de especialistas em engenharia de software, que priorizam a comunicação clara de intenções através da estrutura do código, nomes de variáveis e comentários narrativos. A skill instrui o agente a não apenas escrever código funcional, mas também a fornecer comentários explicativos (narrativas) sobre as decisões de design e sugerir melhorias estruturais que tornem o código mais 'habitável' – ou seja, fácil de entender, modificar e manter tanto por humanos quanto por outras IAs. Ela é independente de plataforma, funcionando com qualquer agente de codificação que suporte o formato de skill como instruções de sistema ou contexto. Ao aplicar esta skill, o agente deve analisar o código gerado ou existente e adicionar camadas de significado e justificativa, transformando código potencialmente 'opaco' em código que conta uma história clara e coerente sobre seu propósito e funcionamento, facilitando futuras iterações e colaboração.
npx skills add jasim/legible-codeMinha visão subjetiva sobre código habitável, tanto para humanos quanto para IA. Destilado da experiência pessoal e da sabedoria coletiva de profissionais que confio. Empacotado como uma Habilidade de Agente que permite que agentes de codificação forneçam comentários narrativos e melhorias de design estrutural para código gerado por IA.
ElevenLabs text-to-speech with mac-style say UX.
Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.
Capture and automate macOS UI with the Peekaboo CLI.
Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".
Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".