VISÃO GERAL
O que será instalado
O pacote público oferece duas skills que compartilham o mesmo espaço de aprendizagem:
aprender: conduz explicações, perguntas e pequenos desafios de estudo.construir: acompanha projetos executáveis e pode retomar o contexto da skill de estudo.
A instalação global deixa as skills disponíveis em todos os projetos deste usuário no computador, sem copiá-las para cada repositório. Você ainda precisa escolher o coding agent compatível onde quer usá-las. A instalação não conecta sua conta ao MCP; essa configuração é feita em outro guia.
INSTALAÇÃO GLOBAL
Instale as duas skills para seu usuário
- Abra o Terminal no seu computador.
- Copie e execute o comando. A opção
--globalinstala no diretório do usuário, para reutilizar as skills em diferentes projetos.
npx skills add kipperacademy/skillpper --skill aprender construir --global- Quando o instalador pedir, selecione o coding agent em que deseja usar as skills. Se quiser usar em mais de um agente, repita a instalação escolhendo outro agente.
- Confirme a instalação e reinicie o agente se ele já estava aberto.
Para instalar apenas em um agente específico, acrescente --agent codex, --agent claude-code ou --agent cursor ao comando. A lista de agentes compatíveis depende da versão atual do instalador.
MEMÓRIA LOCAL
Prepare a pasta para salvar aprendizados
As skills usam a mesma pasta para recuperar o contexto entre conversas e entre projetos. No macOS e Linux, o local padrão é ~/.kipperacademy/aprender/.
- No Terminal, crie a pasta principal:
mkdir -p ~/.kipperacademy/aprender- Use o mesmo usuário do computador ao abrir seu coding agent. Assim, ele encontra a pasta no seu diretório pessoal.
- Na primeira sessão, a skill cria os arquivos e subpastas necessários dentro dela.
Histórico local: a memória fica no seu computador. Os arquivos locais de aprendizagem não são sincronizados pelo MCP.
ARQUIVOS E HISTÓRICO
O que a skill guarda na pasta
A estrutura é criada conforme você estuda. Preferências ficam em NOTES.md; cada assunto tem sua própria pasta em topics/, com missão, sessão e plano para retomar do ponto certo.
~/.kipperacademy/aprender/
├── NOTES.md
├── learning-records/
│ └── 0001-<assunto>.md
├── events.jsonl
└── topics/
└── <assunto>/
├── MISSION.md
├── SESSION.md
├── PLAN.md
└── reference/Cada pasta em topics/ mantém a missão, a sessão atual e o plano de um assunto; isso permite continuar uma atividade sem recomeçar a conversa. Em modo local, os arquivos em learning-records/ guardam aprendizados que mudam o que estudar depois, como um conceito demonstrado, uma dificuldade corrigida ou uma mudança de objetivo. Eles são numerados em sequência e não servem como transcrição de cada conversa.
Se a pasta pessoal não puder ser escrita, as skills usam .aprender/ dentro do diretório de trabalho atual. Nesse caso, o histórico pode não acompanhar você ao trocar de projeto. A skill deve informar esse limite.
A variável APRENDER_HOME pode apontar para outro local persistente. Ela substitui a pasta padrão para as duas skills.
PRIMEIRA SESSÃO
Abra a skill no seu coding agent
Inicie uma conversa e escolha aprender na lista de skills. Você também pode chamar /aprender; no Codex, use $aprender ou selecione pelo menu de skills.
Peça um objetivo concreto, por exemplo: “Quero entender como uma API REST valida uma requisição”. A skill lê os arquivos de estado disponíveis, propõe uma atividade e salva o que for necessário para retomar.
DÚVIDAS FREQUENTES
Instalação e histórico
Preciso instalar a skill em cada projeto?
Não. A opção --global instala para seu usuário e disponibiliza a skill nos projetos compatíveis.
O histórico acompanha a skill para outro computador?
Não automaticamente. A pasta ~/.kipperacademy/aprender/ fica no seu computador. Para mover o histórico, copie essa pasta para o mesmo local no outro computador.
O que vai para learning-records/?
Só registros concisos que ajudam a adaptar estudos futuros, como entendimento demonstrado ou uma dificuldade importante corrigida. Não é um arquivo de transcrição.