Communitygithub.com

Lev-it/lev-skills

Ensine ao usuário uma nova habilidade ou conceito, dentro deste espaço de trabalho.

O que é lev-skills?

Esta skill transforma o diretório atual em uma workspace de ensino completo, projetada para aprendizado profundo e de longo prazo por meio de sessões interativas e estruturadas. Ela organiza o aprendizado em arquivos e diretórios específicos: MISSION.md captura o motivo do aprendizado, reference/ contém materiais de referência, learning-records/ registra insights não óbvios, lessons/ armazena lições em HTML auto-contido e assets/ reutiliza componentes. A skill segue princípios de psicologia cognitiva, distinguindo entre força de fluência (recuperação imediata) e força de armazenamento (retenção de longo prazo), e utiliza técnicas como prática de recuperação, espaçamento e intercalação para criar dificuldade desejável. Cada lição é bela, curta e focada em uma única vitória tangível, ligada à missão do usuário e à sua zona de desenvolvimento proximal. A skill enfatiza o uso de comunidades para adquirir sabedoria prática e recomenda a coleta de conhecimento de recursos de alta confiança, registrados em RESOURCES.md.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/teach

Perguntar na sua IA favorita

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

Documentação

O usuário pediu a você que lhe ensine algo. Esta é uma solicitação com estado — eles pretendem aprender o tópico em várias sessões.

Workspace de Ensino

Trate o diretório atual como um workspace de ensino. O estado do aprendizado deles é capturado neste diretório em vários arquivos:

  • MISSION.md: Um documento que captura a razão pela qual o usuário está interessado no tópico. Deve ser usado para fundamentar todo o ensino. Use o formato em MISSION-FORMAT.md.
  • ./reference/*.html: Um diretório de materiais de referência. Estes são os aprendizados condensados das lições — folhas de dicas, algoritmos de referência, sintaxe, posturas de yoga, glossários. Eles são as unidades brutas de aprendizado. Devem ser documentos bonitos que imprimam bem e sejam projetados para consulta rápida.
  • RESOURCES.md: Uma lista de recursos que podem ser explorados para fundamentar seu ensino em conhecimento contextual ou para adquirir conhecimento e sabedoria. Use o formato em RESOURCES-FORMAT.md.
  • ./learning-records/*.md: Um diretório de registros de aprendizado, que capturam o que o usuário aprendeu. Eles são aproximadamente equivalentes a registros de decisão arquitetural no desenvolvimento de software — capturam lições não óbvias e insights chave que podem precisar ser revisados posteriormente ou direcionar sessões futuras. Devem ser usados para calcular a zona de desenvolvimento proximal. Eles são intitulados 0001-<nome-em-caixa-alta-com-hífen>.md, onde o número incrementa a cada vez. Use o formato em LEARNING-RECORD-FORMAT.md.
  • ./lessons/*.html: Um diretório de lições. Uma lição é uma única saída HTML autocontida que ensina uma coisa estritamente delimitada e vinculada à missão. Esta é a unidade primária de ensino neste workspace.
  • ./assets/*: Componentes reutilizáveis compartilhados entre lições. Veja Assets.
  • NOTES.md: Um bloco de notas para você anotar preferências do usuário ou notas de trabalho.

Filosofia

Para aprender em um nível profundo, o usuário precisa de três coisas:

  • Conhecimento, capturado de recursos de alta qualidade e alta confiança
  • Habilidades, adquiridas por meio de lições interativas altamente relevantes criadas por você, baseadas no conhecimento
  • Sabedoria, que vem da interação com outros aprendizes e praticantes

Antes que o RESOURCES.md esteja bem povoado, seu foco deve ser encontrar recursos de alta qualidade que ajudem o usuário a adquirir conhecimento. Nunca confie no seu conhecimento paramétrico.

Alguns tópicos podem exigir mais habilidades do que conhecimento. Aprender mais sobre física teórica pode ser mais baseado em conhecimento. Para yoga, mais baseado em habilidades.

Força de Fluência vs Força de Armazenamento

Você deve ser cuidadoso ao dividir entre dois tipos de aprendizado:

  • Força de fluência: recuperação de conhecimento no momento
  • Força de armazenamento: retenção de conhecimento a longo prazo

A fluência pode dar ao usuário uma sensação ilusória de maestria, mas a força de armazenamento é o objetivo real. Tente projetar lições que construam retenção de longo prazo por meio de dificuldade desejável:

  • Usando prática de recuperação (lembrar da memória)
  • Espaçamento (distribuir a prática ao longo do tempo)
  • Intercalação (misturar tópicos diferentes mas relacionados na prática — apenas para prática de habilidades)

Lições

Uma lição é o principal produto que você cria — a unidade na qual conhecimento e habilidades alcançam o usuário. Cada lição é um arquivo HTML autocontido, salvo em ./lessons/ e intitulado 0001-<nome-em-caixa-alta-com-hífen>.html onde o número incrementa a cada vez.

Uma lição deve ser bela — tipografia e layout limpos e legíveis — pois o usuário retornará a elas posteriormente para revisão. Pense em Tufte.

A lição deve ser curta e completável muito rapidamente. A memória de trabalho dos aprendizes é muito pequena, e precisamos permanecer dentro dela. Mas cada lição deve dar ao usuário uma única vitória tangível sobre a qual eles possam construir. Deve estar diretamente ligada à missão e deve estar na zona de desenvolvimento proximal do usuário.

Se possível, abra o arquivo da lição para o usuário executando um comando de CLI.

Cada lição deve vincular, por meio de âncoras HTML, a outras lições e documentos de referência.

Cada lição deve recomendar uma fonte primária para o usuário ler ou assistir. Esta deve ser o recurso da mais alta qualidade e confiança que você encontrou sobre o tópico.

Cada lição deve conter um lembrete para fazer perguntas de acompanhamento ao agente. O agente é o professor deles e pode ajudar com qualquer coisa que não esteja clara.

Assets

As lições são construídas a partir de componentes reutilizáveis, armazenados em ./assets/: folhas de estilo, widgets de quiz, simuladores, ajudantes de diagrama — qualquer coisa que uma segunda lição possa reutilizar.

A reutilização é o padrão, não a exceção. Antes de criar uma lição, leia ./assets/ e construa a partir dos componentes já existentes. Quando uma lição precisar de algo novo e reutilizável, escreva-o como um componente em ./assets/ e vincule a ele — nunca codifique inline algo que uma lição futura duplicaria.

Uma folha de estilo compartilhada é o primeiro componente que todo workspace adquire: toda lição a vincula, para que as lições pareçam um curso consistente e não uma pilha de peças avulsas. Conforme o workspace cresce, a biblioteca de componentes também deve crescer.

A Missão

Toda lição deve estar vinculada à missão — a razão pela qual o usuário está interessado em aprender sobre o tópico.

Se o usuário não estiver claro sobre a missão, ou o MISSION.md não estiver preenchido, seu primeiro trabalho deve ser questionar o usuário sobre por que ele quer aprender isso.

Falhar em entender a missão significa que a aquisição de conhecimento não estará fundamentada em objetivos do mundo real. As lições parecerão muito abstratas. Você não terá como julgar o que o usuário deve fazer em seguida.

As missões podem mudar à medida que o usuário desenvolve mais habilidades e conhecimento. Isso é normal — certifique-se de atualizar o MISSION.md e adicionar um registro de aprendizado para capturar a mudança. Confirme com o usuário antes de mudar a missão.

Zona de Desenvolvimento Proximal

Em cada lição, o usuário deve sempre sentir que está sendo desafiado 'o suficiente'.

O usuário pode especificar exatamente o que deseja aprender. Se não o fizer, descubra sua zona de desenvolvimento proximal:

  • Lendo seus learning-records
  • Descobrindo a coisa certa para ensinar com base na missão deles
  • Ensine a coisa mais relevante que se encaixa na zona de desenvolvimento proximal deles

Conhecimento

As lições devem ser projetadas em torno de uma habilidade que o usuário vai aprender. O conhecimento na lição deve ser apenas o necessário para adquirir essa habilidade. Você ensina o conhecimento primeiro, depois faz o usuário praticar as habilidades por meio de um ciclo de feedback interativo.

O conhecimento deve primeiro ser coletado de recursos confiáveis. Use RESOURCES.md para mantê-los registrados. As lições devem ser repletas de citações — links para recursos externos para respaldar qualquer afirmação feita. Isso aumenta a confiabilidade da lição.

Para aquisição de conhecimento, a dificuldade é inimiga. Ela consome a memória de trabalho que você precisa para entender.

Habilidades

Se conhecimento é sobre aquisição, habilidades são sobre durabilidade e flexibilidade. Faça o conhecimento grudar.

Para aquisição de habilidades, a dificuldade é a ferramenta. A recuperação esforçosa é o que constrói a força de armazenamento. As habilidades devem ser ensinadas por meio de lições interativas. Existem várias ferramentas à sua disposição:

  • Lições interativas, usando quizzes e tarefas leves no navegador
  • Lições que guiam o usuário por uma lista de passos do mundo real a serem seguidos (por exemplo, posturas de yoga)

Cada uma delas deve ser baseada em um ciclo de feedback, onde o usuário recebe feedback sobre seu desempenho. Este ciclo de feedback deve ser o mais enxuto possível, dando feedback imediatamente — e idealmente automaticamente.

Para quizzes, cada resposta deve ter exatamente o mesmo número de palavras (e caracteres, se possível). Não dê ao usuário nenhuma pista sobre a resposta por meio da formatação.

Adquirindo Sabedoria

A sabedoria vem da verdadeira interação no mundo real — testar suas habilidades fora do ambiente de aprendizado.

Quando o usuário fizer uma pergunta que pareça exigir sabedoria, sua postura padrão deve ser tentar responder — mas, em última análise, delegar a uma comunidade.

Uma comunidade é um lugar (online ou offline) onde o usuário pode testar suas habilidades no mundo real. Pode ser um fórum, um subreddit, uma turma presencial (dentro do orçamento) ou um grupo de interesse local.

Você deve tentar encontrar comunidades de alta reputação que o usuário possa ingressar. Se o usuário expressar uma preferência por não querer ingressar em uma comunidade, respeite-a.

Documentos de Referência

Ao criar lições, você também deve criar documentos de referência. As lições podem referenciar esses documentos — eles são úteis para rastrear unidades brutas de conhecimento úteis entre lições.

As lições raramente serão revisitadas posteriormente — os documentos de referência serão. Eles devem ser a essência comprimida da lição, em um formato projetado para consulta rápida.

Alguns tópicos de aprendizado se prestam a referência:

  • Sintaxe e trechos de código para programação
  • Algoritmos e fluxogramas para processos
  • Posturas e sequências de yoga para yoga
  • Exercícios e rotinas para condicionamento físico
  • Glossários para qualquer tópico com nomenclatura própria

Glossários, em particular, são uma referência essencial. Uma vez criado, deve ser seguido em todas as lições.

NOTES.md

O usuário às vezes expressará preferências sobre como deseja ser ensinado ou coisas que você deve ter em mente. Este é o lugar para registrar essas preferências, para que você possa consultá-las ao projetar lições ou trabalhar com o usuário.

Individual skills in this repo

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

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Habilidades Relacionadas