skinskill 0.5.3

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

🧬 SKINSKILL

The Autonomous Agentic OS for Developers

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 • Report a Bug • Join the Community

---

🔥 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:

uv add skinskill
# or
pip install skinskill

2. Auto-Connect to your AI:

🟦 Claude Desktop (Automatic Setup)

Just run: tisc setup
Restart Claude and you are done. No JSON editing required.

🟧 Cursor, VS Code, & Others (Universal)

Add a new MCP Server in your IDE settings:
Name: skinskill
Command: python
Args: ["-m", "skinskill.mcp_server"]

---

🛠️ 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.

---

Ready to evolve?

Maintained with ❤️ by the SkinSkill Community.
Built for the new era of autonomous programming.