rogerchappel/skill-portability-audit

O que skill-portability-audit faz?

Audita habilidades de agentes quanto à portabilidade, aprovações e suposições de máquina local.

Visão Geral

Esta skill analisa outras skills de agente (como as usadas no Claude Code, Cursor ou Codex) e verifica se elas são portáveis, seguras e não assumem acesso irrestrito à máquina local. Ela gera um relatório destacando:

• Portabilidade: A skill pode ser executada em diferentes sistemas operacionais ou ambientes?
• Aprovações: A skill solicita aprovação antes de executar ações potencialmente perigosas?
• Suposições de Máquina Local: A skill assume que certas ferramentas, bibliotecas ou caminhos de arquivo existem localmente?

Como Usar

1. Instale a skill no seu agente (ex.: Claude Code, Cursor).
2. Execute o comando: audit portabilidade <caminho-para-skill>
3. A skill lerá o arquivo SKILL.md da skill alvo e produzirá um relatório de auditoria.

Exemplo

# Auditoria de uma skill local
skill-portability-audit ./minha-skill

Como Funciona

A skill parseia o arquivo SKILL.md da skill alvo, identificando:

• Comandos shell específicos do sistema (ex.: apt-get, brew, choco)
• Caminhos de arquivo hardcoded (ex.: /usr/local/bin, C:\Arquivos de Programas)
• Menções a aprovações ou confirmações
• Dependências de ferramentas externas (ex.: git, python3, docker)

Com base nisso, ela classifica cada skill como:

• ✅ Portável: Sem suposições específicas de plataforma.
• ⚠️ Parcialmente Portável: Possui algumas suposições, mas pode ser adaptada.
• ❌ Não Portável: Depende fortemente de ferramentas ou caminhos específicos do sistema.

Requisitos

• Agente compatível com skills (Claude Code, Cursor, Codex ou similar)
• Acesso de leitura ao sistema de arquivos para auditar skills locais

Limitações

• Não executa a skill auditada; apenas analisa seu código/documentação.
• Pode não detectar todas as suposições implícitas (ex.: variáveis de ambiente não documentadas).

Licença

MIT