Skip to main content

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

Project description

🧬 SkinSkill: The Agentic OS for AI

MCP Protocol Python 3.10+ Status


🚀 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)

uv add skinskill

Usando PIP tradicional

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:

{
  "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.


Feito com ❤️ por Agente0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skinskill-0.2.1.tar.gz (2.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

skinskill-0.2.1-py3-none-any.whl (12.1 kB view details)

Uploaded Python 3

File details

Details for the file skinskill-0.2.1.tar.gz.

File metadata

  • Download URL: skinskill-0.2.1.tar.gz
  • Upload date:
  • Size: 2.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for skinskill-0.2.1.tar.gz
Algorithm Hash digest
SHA256 1df8e558ccc024ad9d8c2fde51a60cc06f9b02f3d8a589b031ab5f3f92deee9b
MD5 24fb7f6a3d04eaad71d99831bb454c28
BLAKE2b-256 b93e2d979a816fdd8eae3c49f2ec07e29485888df4fdbc42f92ff36f115a0812

See more details on using hashes here.

File details

Details for the file skinskill-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: skinskill-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 12.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for skinskill-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 52a440932956a53507a3e9f8f5af7c60aa2415d8c9aa911878e66bc4c44d1d3b
MD5 09367bb5fc444606be5d7d0d073ebdcd
BLAKE2b-256 d060561578374fee47affe1dd6800e6df9f65ef15227477881da70268b1abcca

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page