Metadata-Version: 2.4
Name: super-skill
Version: 1.0.0
Summary: Claude Code ecosystem manager for digital agencies
License: MIT
Keywords: agencia-digital,ai-agents,claude-code,cli,ecosystem
Requires-Python: >=3.11
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Requires-Dist: typing-extensions>=4.0
Description-Content-Type: text/markdown

# SUPER-SKILL

Plataforma de automatización para agencias digitales modernas.

## Qué es

SUPER-SKILL es una CLI inteligente (`ss`) que gestiona proyectos de agencia digital. Analiza el contexto de cada proyecto, activa los recursos necesarios, genera planes de trabajo y ejecuta tareas rutinarias. El usuario define los objetivos; el sistema propone y ejecuta.

## Estado

**v1.0 Stable** · Release Candidate 1 · Feature Freeze activo · 1229 tests, 0 regresiones.

## Instalación

```bash
# Requiere Python 3.11+
git clone git@github.com:metasoluciones/super-skill.git
cd super-skill

# Instalar dependencias
pip install typer rich

# Instalar globalmente
ln -s "$(pwd)/platform/super-skill" ~/.local/bin/ss
```

## Uso

```bash
ss today                        # Plan del día + portfolio
ss workspace <proyecto>         # Abrir proyecto
ss blueprint --execute          # Ejecutar plan de trabajo
ss close                        # Cerrar y guardar progreso

ss assistant "mejorar SEO"      # Asistente IA
ss discover                     # Recursos recomendados
ss health                       # Salud del ecosistema
ss doctor                       # Diagnóstico del sistema
```

## Arquitectura

```
super-skill/
├── platform/          # CLI + servicios (74 módulos Python)
│   ├── super-skill    # Entry point (Typer)
│   └── _superskill/   # Motores: Blueprint, Knowledge, Discovery, Policy, Feedback
└── SUPER_SKILL_OS/    # Sistema Operativo Documental (25 docs, 5 dominios)
    ├── CORE/          # Filosofía, arquitectura, equipo, workflow
    ├── GOVERNANCE/    # Calidad, seguridad, decisiones
    ├── PLATFORM/      # Runtime, motores, skills/MCP
    ├── BUSINESS/      # SEO/GEO, WordPress, automatización, agencia
    └── USER/          # Guía, flujo diario, referencia CLI
```

## Tests

```bash
cd platform && python3 -m pytest tests/ -q
# 1229 passed in ~2s
```

## Documentación

- [Guía de Usuario](SUPER_SKILL_GUIA.docx) — documento Word para usuarios finales
- [SUPER_SKILL_OS/](SUPER_SKILL_OS/) — Sistema Operativo Documental completo
- [platform/CHANGELOG.md](platform/CHANGELOG.md) — historial de cambios

## Licencia

Uso privado — metasoluciones.
