SKILLS-GROK

Biblioteca de skills de nivel senior para Grok
Procedimientos versionados, validados y agnósticos de producto
para que el agente se comporte como un equipo de ingeniería completo.

Quick start · Skills · Cómo funciona · Estructura · Install · Contribuir

---

Por qué existe

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

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

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

---

⚡ Quick start

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

En ~/.grok/config.toml:

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

En Grok:

/skills
/full-dev-team

Guía completa → docs/install.md

---

🧩 Skills

	Skill	Slash	Status	Qué desbloquea
	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

Spotlight — full-dev-team

  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

Referencias incluidas (11)

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

---

🗺️ Cómo funciona

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

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

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

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

CI en cada push/PR a main → workflow validate

---

✨ Crear un skill nuevo

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 · humanos: CONTRIBUTING.md

---

📖 Docs

Doc	Para quién
Install	Conectar Grok
Architecture	Mantenedores
Skill spec	Autores de skills
Philosophy	Por qué así
Brand assets	Banner / logo
Changelog	Historial

---

🎨 Brand

Banner	docs/assets/banner.svg
Logo	docs/assets/logo.svg
Paleta	Night #070B16 · Cyan #22D3EE · Violet #8B5CF6 · Pink #F472B6

---

_{MIT © 2026 leonardeco · Built for Grok · Independent skill library}