Metadata-Version: 2.4
Name: skinskill
Version: 0.5.6
Summary: SkinSkill: The Agentic OS for AI. Universal MCP for Autonomous Sniffing, Healing, and Design Mirroring.
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/branding/banner.svg" alt="SkinSkill Banner" width="100%">

# SkinSkill: The Agentic OS for AI
**The Ultimate Modular Engine for Autonomous Developers**

[![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/skinskill?style=for-the-badge&color=orange)]()

**Stop babysitting your AI. Start building products.**  
*SkinSkill is the modular agentic engine that transforms standard AI assistants into Senior Engineers with a persistent brain, computer vision, and an infinite arsenal of skills.*

</div>

---

## ⚡ Why SkinSkill?

Most AI assistants are **blind** to your local machine and **amnesic** between sessions. You waste your day re-explaining context and manually fixing environment errors.

**SkinSkill fixes this.** It connects your AI to your machine via the **Model Context Protocol (MCP)**, providing persistent memory, a self-healing terminal, and a professional-grade office suite out-of-the-box.

---

## 🔥 Super Habilidades (The 7+ Elite Arsenal)

SkinSkill v0.5.x comes "Batteries Included" with modular intelligence:

### 🧠 1. Neural Memory & Token Economy
The AI finally has a long-term brain. It remembers decisions across sessions and models.
*   **Memory Recall:** Switch from Claude to Gemini without losing context.
*   **Caveman Compression:** Save up to **70% of tokens** while preserving technical meaning.

### 🏥 2. Self-Healing Terminal
Build broke? Port 3000 in use? Zombie process? 
*   The AI intercepts errors, identifies the root cause, and **fixes the environment autonomously** with your permission. Zero copy-paste needed.

### 👁️ 3. Design DNA & Vision
Your IA gains "Eyes" to see the internet like a Frontend Senior.
*   **UI DNA:** Extract exact CSS, colors, and fonts from any URL for surgical cloning.
*   **Screenshots:** AI takes snapshots of your screen to diagnose visual bugs in real-time.

### 📄 4. Document & Office Engine
Turn your progress into professional artifacts instantly.
*   Generate **PDF** reports, **PPTX** pitch decks, and **DOCX** briefs directly from your code logic.

### 🚀 5. Engineering Elite (Karpathy Mode)
Forces the AI to work like the top 1% of engineers.
*   **Architecture Sniffing:** Instant mapping of legacy repositories.
*   **TDD Enforcement:** Native Test-Driven Development flow and Karpathy simplicity guardrails.

### 🛠️ 6. Skill Creator (Meta-Ability)
The OS is self-evolving. You can tell the IA to "learn a new trick," and it will autonomously write, test, and install a new "Skin" (tool) into your project.

### 📦 7. Batteries Included (`skills_BAT`)
Pre-loaded automation modules for:
*   **Communication:** Email (Send/Read) & Google Calendar integration.
*   **Orchestration:** Multi-agent workflows and smart-routing logic.

---

## ⚡ Quick Start & Setup

**1. Install Global:**
```bash
uv add skinskill
# or
pip install skinskill
```

**2. Auto-Connect (Zero-Touch):**
```bash
tisc setup
```
*Restart your AI Assistant (Claude/Cursor) and you are ready to ship.*

---

## 🟧 Manual MCP Configuration

For IDEs that support manual JSON config (Cursor, VS Code, Windsurf), use:

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

---

<div align="center">
  Feito com ❤️ por <b>SkinSkill | Gleisson Santos</b><br>
  <a href="ROADMAP.md">Roadmap</a> • <a href="DECISIONS.md">Architecture</a> • <a href="MEMORY.md">Brain</a>
</div>
