Metadata-Version: 2.4
Name: super-skill
Version: 1.0.1
Summary: Claude Code ecosystem manager for digital agencies
Project-URL: Homepage, https://github.com/metasoluciones/super-skill
Project-URL: Repository, https://github.com/metasoluciones/super-skill
Project-URL: Bug Tracker, https://github.com/metasoluciones/super-skill/issues
Author-email: metasoluciones <metasoluciones.com@gmail.com>
License: MIT
Keywords: agencia-digital,ai-agents,claude-code,cli,ecosystem
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Utilities
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** · Feature Freeze activo · 1316 tests, 0 regresiones.

## Instalación

```bash
# Requiere Python 3.11+ y uv (https://docs.astral.sh/uv/)
git clone git@github.com:metasoluciones/super-skill.git
cd super-skill

# Instalar en entorno virtual (resuelve todas las dependencias)
uv sync

# Instalar globalmente como comando `ss`
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 && uv run pytest tests/ -q
# 1316 passed in ~2.5s
```

## 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.
