skinskill 0.2.0

🧬 SkinSkill: The Agentic OS for AI. Universal MCP for Autonomous Sniffing, Healing, and Design Mirroring.

🧬 SkinSkill: The Agentic OS for AI

---

🚀 O que é o SkinSkill?

SkinSkill não é apenas uma biblioteca; é o sistema operacional que faltava para o seu Assistente de IA (Cursor, Claude Desktop, Gemini). Ele transforma uma IA passiva em um agente autônomo capaz de sentir, ver, curar e lembrar.

Com o SkinSkill, sua IA ganha "superpoderes" para entender arquiteturas complexas, clonar designs da web e se auto-corrigir em caso de erros de ambiente.

---

🔥 Superpoderes (MCP Tools)

🧠 [BRAIN] Neural Context Memory

Nunca mais perca o contexto! O SkinSkill armazena o "estado mental" das últimas 50 interações. Se o chat travar, se você trocar de LLM ou se houver um desligamento repentino, a IA pode dar um recall e saber exatamente onde parou.

• skinskill_context_save: Salva progresso, objetivos e erros.
• skinskill_context_recall: Restaura a consciência do projeto.

👁️ [EYES] Web & Design DNA

Sua IA agora pode "ver" a internet como um desenvolvedor frontend.

• skinskill_get_web_dna: Extrai HTML/CSS puro de qualquer URL para clonagem instantânea.
• skinskill_screenshot: Captura a tela do seu computador para a IA diagnosticar bugs visuais.

💉 [HANDS] Surgical Injection

Injete código com precisão milimétrica sem destruir o que já existe.

• skinskill_inject: Insere imports ou chamadas de função nos pontos exatos.
• skinskill_save_skin: Cria novos componentes na pasta /skins.

🏥 [HEAL] Autonomous Diagnostic

Chega de lutar contra o ambiente.

• skinskill_sniff: Analisa o DNA do projeto (frameworks, segredos, estrutura).
• skinskill_diagnose_env: Detecta portas ocupadas, variáveis faltando ou falhas de rede.
• skinskill_execute_fix: Executa comandos de reparo diretamente no shell.

---

🛠️ Instalação Relâmpago

O SkinSkill é Zero-Config. Ele instala até os navegadores do Playwright sozinho na primeira execução.

Usando UV (Recomendado - 10x mais rápido)

uv add skinskill

Usando PIP tradicional

pip install skinskill

---

📂 Estrutura do Projeto

Ao iniciar, o SkinSkill cria uma infraestrutura inteligente na sua pasta:

• .skinskill/: Onde mora a memória neural e os registros de saúde.
• skins/: Onde seus novos componentes gerados pela IA são guardados.
• GEMINI.md / INSTRUCTIONS.md: Instruções automáticas injetadas para que a IA saiba como usar os poderes.

---

🛠️ Como Usar no seu Assistente?

Basta registrar o servidor MCP no seu cliente favorito:

Configuração do Claude Desktop:

{
  "mcpServers": {
    "skinskill": {
      "command": "python",
      "args": ["-m", "skinskill.mcp_server"]
    }
  }
}

---

🛡️ Segurança

O SkinSkill opera localmente. Seus segredos do .env e seu histórico de memória nunca saem da sua máquina.

---

Feito com ❤️ por Agente0