Skill de IA para temas e módulos
Instale a skill archr-launcher-dev para que o Claude Code ou outro assistente de código crie, teste e publique temas e módulos do archr-launcher.
archr-launcher-dev é uma skill para assistentes de código. Ela reúne as referências de temas e módulos do archr-launcher num formato que o assistente lê sozinho: as chaves do theme.toml e seus limites, o manifesto do módulo, o protocolo JSON-RPC, as permissões, a sandbox, as regras da Loja de temas e da Loja de módulos e uma lista de conferência para antes de publicar. Com ela instalada, você pede um tema ou um módulo com suas palavras e o assistente trabalha com as regras reais do launcher em vez de adivinhar.
A skill segue o formato Agent Skills, uma pasta com um SKILL.md, e por isso funciona no Claude Code e em outras ferramentas que leem esse formato. Código e versões: archr-linux/archr-skills. O conteúdo da skill é em inglês, para servir a desenvolvedores de qualquer lugar; os pedidos podem ser em português.
O que vem na skill
| Arquivo | Conteúdo |
|---|---|
SKILL.md | O fluxo (criar, testar no PC, testar no aparelho, publicar) e as regras que o assistente precisa seguir |
references/themes.md | Todas as chaves do theme.toml, visualizações, molduras, sons, a captura no PC, as regras da Loja de temas |
references/modules.md | module.toml, protocolo da API 2, permissões, sandbox, ciclo de vida, as regras da Loja de módulos |
references/checklist.md | O que conferir antes de publicar um tema ou um módulo |
assets/ | Um tema e um módulo mínimos que passam nas checagens do launcher |
scripts/precheck.py | Uma checagem estática da pasta de um tema ou módulo (Python 3.11 ou mais novo) |
Ela cobre a API 2 dos módulos, a atual. As páginas detalhadas continuam sendo Criar temas e Criar módulos; quando o launcher muda, os docs/temas.md e docs/modulos.md do próprio launcher são a referência.
Instalar no Claude Code
Adicione o marketplace
Dentro do Claude Code:
/plugin marketplace add archr-linux/archr-skillsInstale o plugin
/plugin install archr@archr-skillsReinicie o Claude Code
A skill carrega sozinha quando você pede um tema ou módulo do ArchR. Também dá para chamá-la direto com /archr:archr-launcher-dev.
O mesmo pelo terminal:
claude plugin marketplace add archr-linux/archr-skills
claude plugin install archr@archr-skillsPara atualizar quando sair uma versão nova:
claude plugin marketplace update archr-skills
claude plugin update archr@archr-skillsInstalar à mão
Copie a pasta da skill para a sua pasta pessoal de skills:
git clone https://github.com/archr-linux/archr-skills
mkdir -p ~/.claude/skills
cp -r archr-skills/archr-launcher-dev ~/.claude/skills/Para usar só num projeto, copie a pasta para .claude/skills/ dentro dele. Outros assistentes compatíveis com Agent Skills leem a mesma pasta a partir do próprio diretório de skills; a documentação de cada um diz qual é.
O que pedir
Descreva o resultado que você quer e onde ele deve ficar. Alguns exemplos:
- "Crie um tema do ArchR chamado Pôr do sol: laranja sobre roxo escuro, cantos retos, a lista de jogos à direita e a capa à esquerda. Nomes em inglês, português, espanhol e russo."
- "Acrescente ao meu tema uma segunda visualização em que a tela de sistemas mostre blocos grandes, e gere capturas das duas."
- "Escreva um módulo do archr-launcher com um bloco no menu Start que mostre o espaço livre da partição de ROMs e uma página de ajustes para escolher a unidade."
- "Meu módulo é recusado com 'not an unmodified Lucide icon'. Descubra por quê."
- "Prepare o repositório do meu tema para a Loja de temas e faça a primeira release."
Para um tema, o assistente desenha as telas reais do launcher no seu computador com a captura descrita em Testar o tema e olha o resultado. Para um módulo, ele roda archr-launcher --check-module e manda mensagens JSON ao módulo à mão. As duas coisas precisam de um clone do repositório do launcher e das bibliotecas de desenvolvimento do SDL2; os comandos exatos estão nas referências da skill.
Limites
A skill não substitui o teste no aparelho. Uma captura no PC e um --check-module sem erros não provam que o tema fica legível na tela de 3,5", que o módulo roda dentro da sandbox nem que ele continua funcionando depois de um jogo. Copie o resultado para o aparelho por SSH e experimente antes de publicar.
A skill não dá a um módulo o selo Revisado pelo ArchR. Só o mantenedor do ArchR concede o selo, depois de ler o pacote exato publicado na release; uma release nova perde o selo até ser revisada outra vez. Para pedir revisão, abra uma issue em archr-linux/archr-modules com o link da release.
O assistente ainda pode errar. Leia o que ele escreve e confira se cada chave usada aparece em Criar temas ou Criar módulos: o launcher ignora chaves desconhecidas sem dar erro.