Metadata-Version: 2.4
Name: skillcode
Version: 1.1.5
Summary: SkinSkill: The Infinite Loop Agentic OS. Universal MCP for Self-Evolving AI Engineering, OS Control, and Design DNA.
Project-URL: Homepage, https://github.com/corefusiion/SkinSkill
Project-URL: Documentation, https://github.com/corefusiion/SkinSkill#readme
Project-URL: Issues, https://github.com/corefusiion/SkinSkill/issues
Author-email: Agente0 <suporte@agente0.ai>
Keywords: agent,ai,automation,context-memory,docx,mcp,pdf,playwright,pptx
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-docx>=1.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: python-pptx>=0.6.21
Requires-Dist: reportlab>=4.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer[all]>=0.9.0
Description-Content-Type: text/markdown

<div align="center">

<img src="https://raw.githubusercontent.com/corefusiion/SkinSkill/main/skillcode/img/img01.png" alt="SkillCode Agent" width="800">

# 🧠 SkillCode (skc)
**The Ultimate Self-Evolving Developer Agent & Embedded MCP OS for AI**

[![MCP Protocol](https://img.shields.io/badge/MCP-Protocol-blueviolet?style=for-the-badge&logo=ai)]()
[![Python](https://img.shields.io/badge/Python-3.10%2B-blue?style=for-the-badge&logo=python)]()
[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)]()
[![PyPI](https://img.shields.io/pypi/v/skillcode?style=for-the-badge&color=orange)](https://pypi.org/project/skillcode/)

**Bem-vindo ao Futuro da Engenharia Autônoma de Software.**  
*O **SkillCode** não é apenas um servidor MCP—é um **Agente Inteligente Completo (CLI)** com loop de raciocínio autônomo (ReAct), capaz de controlar o sistema operacional, gerar código sob TDD, orquestrar subagentes e **se auto-otimizar em tempo real**. Ele conta com um **Servidor MCP Embutido** para integração imediata com Cursor, VS Code e Windsurf.*

[📖 Read the Experience Guide (TUTORIAL)](./TUTORIAL.md)

</div>

---

## 🚀 O que é o SkillCode?

O **SkillCode** é um agente autônomo de IA projetado para rodar em seu terminal e atuar como um engenheiro de software de elite. Diferente de ferramentas estáticas, o SkillCode possui:

1. **Loop Autônomo de Raciocínio & Ação (ReAct)**: Ele analisa seus objetivos, executa comandos, lê/escreve arquivos e resolve problemas de forma proativa.
2. **Auto-Refatoração e Evolução (Auto-Forge)**: Sempre que se depara com uma tarefa para a qual não tem ferramentas específicas, ele cria uma nova extensão em Python sob a pasta `skins/`, valida-a usando testes (TDD) e a registra dinamicamente sem interromper o loop.
3. **Servidor MCP Integrado**: Expõe todas as suas 23+ super habilidades para qualquer IDE compatível com a especificação Model Context Protocol (MCP).
4. **Interface CLI Premium**: Interface estilizada em roxo, preto e branco com telemetria do sistema operacional no início de cada sessão.

---

## ⚡ As 23 Super Habilidades (Capabilities)

Organizadas para transformar qualquer LLM (Claude, Gemini, GPT-4o, OpenRouter) em um Engenheiro de Elite.

### 🧠 Cérebro & Inteligência (The Brain)
| Ferramenta | O que faz? |
| :--- | :--- |
| `skillcode_sniff` | Analisa instantaneamente o DNA do projeto (frameworks, libs, estrutura). |
| `skillcode_optimize_self` | **O "Loop Infinito"**: Analisa o próprio código e se auto-otimiza. |
| `skillcode_distill_project` | Comprime projetos gigantes em assinaturas de funções (99% de economia de tokens). |
| `skillcode_sigmap_search` | Busca semântica profunda no Índice Neural local do projeto. |

### 👁️ Visão & Design (The Eyes)
| Ferramenta | O que faz? |
| :--- | :--- |
| `skillcode_screenshot` | Captura telas da Web (via Playwright) ou do seu Desktop local (via PyAutoGUI). |
| `skillcode_extract_design_system` | Clona a alma visual (cores, fontes, CSS) de qualquer URL. |
| `skillcode_static_ui_extract` | Extrai tokens de design (Tailwind/CSS) de arquivos locais. |
| `skillcode_vision_audit` | Visual TDD: Compara duas URLs pixel por pixel em busca de diferenças. |

### 🖱️ Controle de OS & Ação (The Hands)
| Ferramenta | O que faz? |
| :--- | :--- |
| `skillcode_ghost_hand` | Controle total: Movimente o mouse, clique e digite em qualquer app do Windows/Mac/Linux. |
| `skillcode_inject` | Injeta código cirurgicamente em qualquer arquivo sem quebrar o contexto. |
| `skillcode_forge_validate_and_save` | O "Ferreiro": Cria novas habilidades, valida com testes e as instala no sistema. |

### 🛡️ Defesa & Auto-Cura (The Shield)
| Ferramenta | O que faz? |
| :--- | :--- |
| `skillcode_security_audit` | Varredura proativa contra vazamento de segredos (API Keys, envs). |
| `skillcode_heal_context` | Diagnostica falhas de comandos e propõe a cura imediata para a IA. |
| `skillcode_watchdog` | Monitoramento autônomo de logs em background para detecção de erros. |

### 📄 Documentação & Arquivos (The Scribe)
| Ferramenta | O que faz? |
| :--- | :--- |
| `skillcode_generate_pdf` | Gera relatórios PDF profissionais via ReportLab. |
| `skillcode_generate_docx` | Cria documentos Word formatados via python-docx. |
| `skillcode_generate_pptx` | Cria apresentações PowerPoint via python-pptx. |
| `skillcode_generate_xlsx` | Cria planilhas Excel via xlsxwriter. |

### 🤝 Memória & Colaboração (The Memory)
| Ferramenta | O que faz? |
| :--- | :--- |
| `skillcode_context_save` | Registra decisões arquiteturais (Shadow-Graph) para memória de longo prazo. |
| `skillcode_shadow_query` | Consulta as decisões passadas para evitar retrabalho ou erros de design. |
| `skillcode_a2a_sync` | Sincronização Inter-Agente: Compartilha o "Blackboard" entre diferentes instâncias. |
| `skillcode_hud_notify` | Envia notificações em tempo real para o Head-Up Display visual do dev. |
| `skillcode_compress_context` | Compactação de texto estilo "Caveman" para economizar contexto em diálogos longos. |

---

## ⚡ Quick Start & Setup

**1. Instalação Global:**
```bash
pip install skillcode --upgrade
```

**2. Configuração do Agente:**
Configure suas chaves de API (OpenRouter, Gemini, Claude, etc.):
```bash
skc config
```

**3. Iniciar o Servidor MCP Embutido:**
Para conectar ao Cursor ou VS Code:
```bash
skc mcp start
```

**4. Ative o HUD (Head-Up Display) Visual:**
```bash
skc hud
```

**5. Comando Geral:**
Para ver a lista completa de comandos CLI:
```bash
skc --help
```

---

<div align="center">
  <b>SkillCode Agentic OS</b> | Onde o código encontra a inteligência autônoma.<br>
  Feito com ❤️ por <a href="https://agente0.ai">Agente0</a>
</div>
