Guía Completa: Creando tu Primera Agent Skill en Cursor

¿Qué es una Agent Skill?

🤔 El problema

Sin skills, cada vez que le pides a Cursor que cree código, debes dar las mismas instrucciones:

Tú: "Crea un controller REST para productos usando Spring Boot, 
     con inyección por constructor, DTOs separados, validaciones,
     y que devuelva ResponseEntity con códigos HTTP correctos"

Esto es tedioso y propenso a errores (olvidas mencionar algo importante).

✅ La solución

Con una skill configurada, solo dices:

Tú: "Crea el CRUD de Producto"

Cursor: [Genera automáticamente Controller + Service + Repository + DTOs 
        siguiendo TODAS tus reglas predefinidas]

¿Cómo funciona?

Tú creas un archivo SKILL.md con tus reglas y ejemplos
Cursor lo lee automáticamente al iniciar
Cuando haces un prompt, Cursor verifica si alguna skill coincide
Si coincide, carga las instrucciones y genera código siguiendo tus estándares

Prerequisitos

✅ Checklist antes de empezar:

Cursor IDE instalado
Proyecto Spring Boot existente con pom.xml configurado
Conocimiento básico de:
- Spring Boot (controllers, services, repositories)
- JPA (entities, relaciones)
- Git (para versionar tus skills)

Nota: Esta guía asume que ya tienes configuradas las dependencias necesarias en tu proyecto (JPA, Validation, Lombok, etc.) según tus preferencias.

Anatomía de una Skill

📂 Estructura de archivos

tu-proyecto/
├── src/
├── pom.xml
└── .claude/                    ← Carpeta de configuración de Cursor
    └── skills/                 ← Aquí van tus skills
        └── spring-crud/        ← Nombre de tu skill
            ├── SKILL.md        ← ARCHIVO PRINCIPAL (obligatorio)
            ├── scripts/        ← (Opcional) Scripts auxiliares
            ├── references/     ← (Opcional) Documentación extra
            └── assets/         ← (Opcional) Templates, diagramas

Estructura del archivo SKILL.md

---
# ============ FRONTMATTER (YAML) ============
# Esta sección es METADATA que Cursor lee primero
name: nombre-de-tu-skill
description: Descripción detallada de CUÁNDO usar esta skill
license: MIT
metadata:
  author: tu-nombre
  version: "1.0.0"
  tags: [spring-boot, crud, jpa]
---

# ============ CUERPO (MARKDOWN) ============
# Aquí van las instrucciones completas

## Cuándo usar esta skill
- Casos de uso específicos

## Stack técnico
- Versiones exactas

## Templates de código
```java

## Restricciones
- Qué NO hacer

## Checklist
- Criterios de validación

Si llegaste hasta aquí, felicidades: ya estás un paso por delante del resto.

He abierto un espacio privado para devs que quieren dejar de picar código y empezar a orquestar agentes de IA como profesionales. Si estás listo para subir de nivel y ver cómo trabajamos por dentro, tienes el acceso a mi comunidad en el link de mi perfil. 🚀

Y si te gusto el contenido sígueme en mis redes sociales.

YouTube

Facebook

TikTok