Metadata-Version: 2.4
Name: skinskill
Version: 0.5.3
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="branding/banner.svg" alt="SkinSkill Banner" width="100%">

# 🧬 SKINSKILL
### **The Autonomous Agentic OS for 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 background engine that transforms standard AI assistants into Senior Engineers with local environment awareness and an elite arsenal of skills.*

[Explore the Roadmap](ROADMAP.md) • [Report a Bug](https://github.com/corefusiion/SkinSkill/issues) • [Join the Community](#)

</div>

---

## 🔥 Why SkinSkill?

Most AI assistants (Claude, Cursor, Gemini) are **blind** to your local machine and **forgetful** when you close the chat. You waste 30% of your day explaining context, copying terminal errors, and manually fixing environment issues.

**SkinSkill fixes this.** It uses the **Model Context Protocol (MCP)** to give your AI "Eyes", "Hands", and a "Neural Brain".

### From "Noob" Struggles to "Pro" Automation:
*   **The Noob Save:** Tired of "Port 3000 already in use" or "Missing .env key" errors? SkinSkill detects them and offers a 1-click fix.
*   **The Pro Power:** Mapping a 50-file legacy architecture in seconds? SkinSkill's `sniff` gives the AI a perfect mental model of your project before it writes a single line of code.

---

## 💎 Elite Skills (Built-in Superpowers)

SkinSkill v0.5.x comes "Batteries Included" with elite logic adapted from the world's best agentic frameworks:

### 🧠 1. Neural Memory & Token Savings
*   **Persistent Context:** The AI remembers your last 50 decisions, goals, and errors. Even if you switch from Claude to Gemini, the context follows you.
*   **Caveman Compression:** Running out of context window? SkinSkill automatically compresses long histories using technical-aware token saving, keeping your AI sharp and your costs low.

### 🏥 2. Self-Healing Environment
*   **Terminal Intelligence:** If a command fails, the AI doesn't just apologize. It analyzes the error (stuck processes, missing dependencies), proposes a fix, and executes it with your permission.

### 👁️ 3. Visual & Design Intelligence
*   **UI DNA Extraction:** Give the AI a URL (e.g., *Stripe*, *Vercel*). It uses a headless browser to extract the exact CSS, colors, and fonts, then clones the component into your project.
*   **Screen Awareness:** AI can "see" your screen to diagnose visual bugs that code analysis alone can't find.

### 📄 4. Document & Marketing Engine
*   **Pro Docs:** Instantly generate professional **PDFs**, **DOCX** reports, or **PPTX** presentations based on your project's progress.
*   **Conversion Copy:** Built-in copywriting frameworks (AIDA/PAS) for creating high-conversion landing pages and ads.

---

## 🚀 Zero-Touch Installation

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

**2. Auto-Connect to your AI:**

<details>
<summary><b>🟦 Claude Desktop (Automatic Setup)</b></summary>
<br>
Just run:
<code>tisc setup</code>
<br>Restart Claude and you are done. No JSON editing required.
</details>

<details>
<summary><b>🟧 Cursor, VS Code, & Others (Universal)</b></summary>
<br>
Add a new MCP Server in your IDE settings:
<br><b>Name:</b> skinskill
<br><b>Command:</b> <code>python</code>
<br><b>Args:</b> <code>["-m", "skinskill.mcp_server"]</code>
</details>

---

## 🛠️ Real-World Scenarios

### 📂 Scenario 1: The Architecture Rescue
> **User:** *"I just cloned this messy repo. Figure out how the auth flow works and add a new profile edit page following the same pattern."*
> **SkinSkill:** Maps the project DNA (`sniff`), identifies the pattern, and injects the new logic surgicaly.

### 🎨 Scenario 2: Instant Design Implementation
> **User:** *"Go to `https://ui.shadcn.com`, extract the DNA of the 'Accordion' component and create a Python/React version in my `/skins` folder."*
> **SkinSkill:** Opens browser, captures styles, and generates the code.

### 🦴 Scenario 3: Context Overflow
> **User:** *"The chat is getting slow. Compress our progress so far."*
> **SkinSkill:** Activates `Caveman Compression`, saving 70% of tokens while retaining 100% of technical intent.

---

<div align="center">
  <h3>Ready to evolve?</h3>
  Maintained with ❤️ by the <b>SkinSkill Community</b>.<br>
  Built for the new era of autonomous programming.
</div>
