Metadata-Version: 2.4
Name: skinskill
Version: 0.2.0
Summary: 🧬 SkinSkill: The Agentic OS for AI. Universal MCP for Autonomous Sniffing, Healing, and Design Mirroring.
Project-URL: Homepage, https://github.com/agente0/skinskill
Project-URL: Documentation, https://github.com/agente0/skinskill#readme
Project-URL: Issues, https://github.com/agente0/skinskill/issues
Author-email: Agente0 <suporte@agente0.ai>
Keywords: agent,ai,automation,context-memory,mcp,playwright
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp[fastmcp]>=0.1.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: playwright>=1.40.0
Requires-Dist: pyautogui>=0.9.54
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer[all]>=0.9.0
Description-Content-Type: text/markdown

# 🧬 SkinSkill: The Agentic OS for AI

<p align="center">
  <img src="https://img.shields.io/badge/MCP-Protocol-blueviolet?style=for-the-badge&logo=ai" alt="MCP Protocol">
  <img src="https://img.shields.io/badge/Python-3.10%2B-blue?style=for-the-badge&logo=python" alt="Python 3.10+">
  <img src="https://img.shields.io/badge/Status-Ultra--Powerful-success?style=for-the-badge" alt="Status">
</p>

---

## 🚀 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)
```bash
uv add skinskill
```

### Usando PIP tradicional
```bash
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:**
```json
{
  "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.

---

<p align="center">
  Feito com ❤️ por <b>Agente0</b>
</p>
