ydilmoni/code-annotator

O que code-annotator faz?

Uma skill para Claude Code / Agent que adiciona comentários ricos e focados na intenção ao seu código — em hebraico ou inglês — sem alterar nenhuma lógica.

Como usar

1. Selecione o código que deseja anotar.
2. Execute o comando da skill (exemplo: /code-annotator).
3. Escolha o idioma: he para hebraico ou en para inglês.
4. A skill retornará o código com comentários adicionados, sem modificar a lógica original.

Requisitos

• Claude Code (ou agente compatível).
• Acesso à skill ydilmoni/code-annotator.

Exemplo

Código de entrada (Python)

def calcular_media(numeros):
    total = sum(numeros)
    return total / len(numeros)

Saída anotada (inglês)

# Calculates the arithmetic mean of a list of numbers
def calcular_media(numeros):
    # Sum all numbers in the list
    total = sum(numeros)
    # Divide the total by the count of elements
    return total / len(numeros)

Comportamento

• Não altera código: apenas insere comentários.
• Comentários focados na intenção: explica o porquê e o que cada parte faz.
• Suporte a dois idiomas: hebraico (direita para esquerda) e inglês.
• Preserva formatação: nomes de variáveis, funções e código permanecem intocados.

Limitações

• Pode não funcionar bem com código altamente ofuscado ou minificado.
• A qualidade dos comentários depende da clareza do código original.

Contribuição

Sinta-se à vontade para abrir issues ou pull requests no repositório oficial.

Licença

MIT