<p align="center">
  <img src="docs/assets/banner.svg" alt="SKILLS-GROK — Senior agent skills library for Grok" width="100%">
</p>

<p align="center">
  <img src="docs/assets/logo.svg" width="88" alt="SKILLS-GROK logo">
</p>

<h1 align="center">SKILLS-GROK</h1>

<p align="center">
  <strong>Biblioteca de skills de nivel senior para <a href="https://x.ai">Grok</a></strong><br>
  Procedimientos versionados, validados y agnósticos de producto<br>
  para que el agente se comporte como un equipo de ingeniería completo.
</p>

<p align="center">
  <a href="https://github.com/leonardeco/SKILLS-GROK/actions/workflows/validate.yml"><img src="https://github.com/leonardeco/SKILLS-GROK/actions/workflows/validate.yml/badge.svg" alt="Validate skills"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-22d3ee?style=flat-square&labelColor=0b1224" alt="MIT"></a>
  <img src="https://img.shields.io/badge/skills-1_stable-a78bfa?style=flat-square&labelColor=0b1224" alt="skills">
  <img src="https://img.shields.io/badge/spec-v1-f472b6?style=flat-square&labelColor=0b1224" alt="skill-spec v1">
  <img src="https://img.shields.io/badge/Grok-compatible-67e8f9?style=flat-square&labelColor=0b1224" alt="Grok">
  <img src="https://img.shields.io/badge/product--agnostic-yes-10b981?style=flat-square&labelColor=0b1224" alt="product-agnostic">
</p>

<p align="center">
  <a href="#-quick-start"><strong>Quick start</strong></a> ·
  <a href="#-skills"><strong>Skills</strong></a> ·
  <a href="#-cómo-funciona"><strong>Cómo funciona</strong></a> ·
  <a href="#-estructura"><strong>Estructura</strong></a> ·
  <a href="docs/install.md"><strong>Install</strong></a> ·
  <a href="CONTRIBUTING.md"><strong>Contribuir</strong></a>
</p>

---

## Por qué existe

<table>
<tr>
<td width="33%" valign="top">

### 🧠 Senior by default
No un “coder genérico”: roles, diseño antes de código, TDD, evidencia y cierre profesional.

</td>
<td width="33%" valign="top">

### 🔒 Seguridad & privacy
Threat modeling, DevSecOps, priorización por riesgo y privacy by design desde la fase 1.

</td>
<td width="33%" valign="top">

### 📦 Biblioteca limpia
Solo skills. Sin acoplar monorepos de producto. Versionada, con CI y contrato formal.

</td>
</tr>
</table>

<p align="center">
  <img src="docs/assets/hero-bg.jpg" alt="Atmosphere — red de skills / agentes" width="92%">
</p>

---

## ⚡ Quick start

```bash
git clone https://github.com/leonardeco/SKILLS-GROK.git
```

En `~/.grok/config.toml`:

```toml
[skills]
paths = ["C:/Users/MI PC/Documents/PROYECTOS/SKILLS-GROK/skills"]
```

En Grok:

```text
/skills
/full-dev-team
```

Guía completa → **[docs/install.md](./docs/install.md)**

---

## 🧩 Skills

| | Skill | Slash | Status | Qué desbloquea |
|:--:|---|---|:--:|---|
| <img src="docs/assets/logo.svg" width="28"> | **[full-dev-team](./skills/full-dev-team/)** | `/full-dev-team` | `stable` | Equipo completo: PO · SM · Arquitecto · UX · FE · BE · FS · QA · SRE |

Catálogo machine-readable: [`catalog/skills.yaml`](./catalog/skills.yaml)

### Spotlight — `full-dev-team`

```text
  DESIGN          PLAN            BUILD           SHIP
 ────────►      ────────►       ────────►       ────────►
  roles           tareas 2-5'     TDD + secure    evidencia
  trade-offs      archivos exactos mini-review    prod ready
  threat / BIA    G/W/T + DoD     code quality    no vibes
```

<details>
<summary><strong>Referencias incluidas (11)</strong></summary>

| Módulo | Tema |
|---|---|
| [workflow-phases](./skills/full-dev-team/references/workflow-phases.md) | Fases y gates |
| [roles-playbook](./skills/full-dev-team/references/roles-playbook.md) | Cómo habla cada rol |
| [test-strategy](./skills/full-dev-team/references/test-strategy.md) | Pirámide, contratos, DoD |
| [business-impact-analysis](./skills/full-dev-team/references/business-impact-analysis.md) | BIA ligero |
| [sre-practices](./skills/full-dev-team/references/sre-practices.md) | SLI / SLO / error budget |
| [threat-modeling](./skills/full-dev-team/references/threat-modeling.md) | STRIDE-lite |
| [devsecops](./skills/full-dev-team/references/devsecops.md) | Seguridad por fase |
| [vulnerability-management](./skills/full-dev-team/references/vulnerability-management.md) | Riesgo > CVSS ciego |
| [production-readiness](./skills/full-dev-team/references/production-readiness.md) | Checklist de salida |
| [privacy-and-data-control](./skills/full-dev-team/references/privacy-and-data-control.md) | Datos + IA local/cloud |
| [adr-template](./skills/full-dev-team/references/adr-template.md) | Decisiones arquitectónicas |

</details>

---

## 🗺️ Cómo funciona

```mermaid
flowchart LR
  U["👤 Tú"] --> G["🤖 Grok"]
  G --> P["config paths → skills/"]
  P --> S["SKILL.md"]
  S --> R["references/ on demand"]
  S --> O["Entrega con evidencia"]

  style U fill:#0b1224,stroke:#67e8f9,color:#e2e8f0
  style G fill:#0b1224,stroke:#a78bfa,color:#e2e8f0
  style P fill:#0b1224,stroke:#f472b6,color:#e2e8f0
  style S fill:#14532d,stroke:#4ade80,color:#ecfdf5
  style R fill:#0b1224,stroke:#38bdf8,color:#e2e8f0
  style O fill:#1e1b4b,stroke:#c4b5fd,color:#e2e8f0
```

| Capa | Ruta | Rol |
|---|---|---|
| **Load surface** | `skills/` | Lo único que Grok debe escanear |
| **Contrato** | `docs/skill-spec.md` | Qué hace válido a un skill |
| **Catálogo** | `catalog/skills.yaml` | Índice versionable |
| **Calidad** | `scripts/` + CI | Falla si el skill está roto |
| **Plantilla** | `templates/skill/` | Crear skills nuevos en minutos |

---

## 🏛️ Estructura

```text
SKILLS-GROK/
├── 📄 README.md
├── ⚖️  LICENSE · SECURITY · CONTRIBUTING · AGENTS
├── 🗂️  catalog/skills.yaml
├── 📚 docs/          architecture · skill-spec · install · philosophy · assets/
├── 🧩 skills/        ★ load surface para Grok
│   └── full-dev-team/
├── 🧱 templates/skill/
├── 🛠️  scripts/       validate-skills.ps1 / .sh
└── 🐙 .github/       CI · PR · issue templates
```

---

## ✅ Quality bar

Todo skill debe pasar **skill-spec v1**:

| Check | Regla |
|:--:|---|
| 🏷️ | `name` válido y = nombre de carpeta |
| 📝 | `description` con triggers + `/slash` |
| 🎯 | Cuerpo accionable (no marketing vacío) |
| 🔗 | Links a `references/*` sin roturas |
| 📇 | Registrado en catálogo + README |
| 🔐 | Cero secretos / PII real |
| 🧱 | Sin acoplar un monorepo de producto |

```powershell
# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\validate-skills.ps1
```

```bash
# Unix / CI
./scripts/validate-skills.sh
```

CI en cada push/PR a `main` → [workflow validate](./.github/workflows/validate.yml)

---

## ✨ Crear un skill nuevo

```text
1. templates/skill/  →  skills/<tu-nombre>/
2. Rellena SKILL.md + references
3. catalog/skills.yaml + tabla del README
4. validate-skills
5. CHANGELOG → PR
```

Proceso para agentes: **[AGENTS.md](./AGENTS.md)** · humanos: **[CONTRIBUTING.md](./CONTRIBUTING.md)**

---

## 📖 Docs

| Doc | Para quién |
|---|---|
| [Install](./docs/install.md) | Conectar Grok |
| [Architecture](./docs/architecture.md) | Mantenedores |
| [Skill spec](./docs/skill-spec.md) | Autores de skills |
| [Philosophy](./docs/philosophy.md) | Por qué así |
| [Brand assets](./docs/assets/README.md) | Banner / logo |
| [Changelog](./CHANGELOG.md) | Historial |

---

## 🎨 Brand

| | |
|---|---|
| Banner | [`docs/assets/banner.svg`](./docs/assets/banner.svg) |
| Logo | [`docs/assets/logo.svg`](./docs/assets/logo.svg) |
| Paleta | Night `#070B16` · Cyan `#22D3EE` · Violet `#8B5CF6` · Pink `#F472B6` |

---

<p align="center">
  <sub>MIT © 2026 <strong>leonardeco</strong> · Built for Grok · Independent skill library</sub>
</p>

<p align="center">
  <img src="docs/assets/logo.svg" width="40" alt="">
</p>
