iamk3nnyt/claude-skills (Resumen de funcionalidad)

Convierte una idea de funcionalidad en un resumen de una página que cubre el problema, la audiencia, el alcance del MVP, los no-objetivos, criterios de aceptación numerados (Dado/Cuando/Entonces), rutas afectadas, datos y correos electrónicos, y preguntas abiertas. Úsalo cuando el usuario diga 'brief', 'spec this', 'scope this' o 'what would it take', o antes de comenzar una funcionalidad cuyo alcance no está claro.

¿Qué es claude-skills (Resumen de funcionalidad)?

Esta habilidad para agentes de IA (como Claude Code, Cursor, Codex) transforma una idea vaga de funcionalidad en un documento estructurado de una página ('brief'). Primero, el agente revisa silenciosamente el contexto del proyecto (archivos CLAUDE.md, entradas de memoria, rutas, esquemas y plantillas de correo) para fundamentar el análisis. Luego aplica reglas estrictas de alcance: el MVP debe usar campos y componentes existentes, y cualquier elemento no solicitado (como nuevas pantallas de administración o analíticas) se lista explícitamente como 'no-objetivo'. El agente solo entrevista al usuario si una decisión cambiaría el alcance, limitándose a un máximo de 3 preguntas. Finalmente, genera un brief en markdown con secciones predefinidas (problema, audiencia, MVP, no-objetivos, criterios de aceptación en formato Given/When/Then, rutas, tablas, correos, riesgos y preguntas abiertas con valores por defecto). La salida se entrega en el chat a menos que se solicite explícitamente un archivo en `docs/briefs/`. La habilidad asegura que cada criterio de aceptación sea observable y que no haya elementos innecesarios en el MVP, permitiendo comenzar la implementación sin esperar.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamk3nnyt/claude-skills/tree/HEAD/skills/brief

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

brief

Funcionalidad: $ARGUMENTS

Primero, fundamenta (en silencio)

  • Lee el archivo CLAUDE.md del repositorio y las entradas de memoria de este proyecto. Revisa las rutas, el esquema y las plantillas de correo que toca la funcionalidad. Las especificaciones citan rutas de archivo reales y campos existentes.
  • Entrevista solo si una decisión cambiaría el alcance. Haz una pregunta a la vez usando AskUserQuestion con una opción recomendada, y limítate a un máximo de 3 preguntas. Cualquier otra cosa se convierte en una suposición en Preguntas abiertas.

Reglas internas para el alcance

  • MVP significa el mínimo convencional construido con campos y componentes existentes. "Como cualquier comercio electrónico" significa el flujo estándar, no una plataforma.
  • Nunca agregues componentes, configuraciones, pantallas de administración o analíticas que no se hayan solicitado. En lugar de eso, enuméralos en No-objetivos.
  • Funcionalidades de socios o API: "clave API" generalmente significa un id de inquilino en env, no un portal para desarrolladores.
  • Respeta las restricciones del proyecto de CLAUDE.md/memoria (por ejemplo, "sin cambios en el esquema"). Señala cualquier cosa que las incumpliría.

Plantilla

# <Funcionalidad>: resumen
**Problema:** una o dos frases, el dolor del usuario, no la solución.
**Para:** quién, y cuántos si se sabe (cita la consulta o fuente).
**MVP:** 3–6 viñetas, cada una entregable y observable.
**No-objetivos:** lo que explícitamente no estamos haciendo ahora.
**Criterios de aceptación**
1. Dado <estado>, cuando <acción>, entonces <resultado observable>.
2. … (cada uno comprobable mediante verificación de flujo, prueba de humo o prueba unitaria)
**Toca:** rutas · tablas/campos (primero los existentes) · correos · env/secretos · terceros
**Riesgos:** dinero, legal/RGPD, entregabilidad, SEO (noindex/canónico), i18n
**Preguntas abiertas:** numeradas; cada una con mi valor por defecto si no se responde

Salida

  • Por defecto en el chat. Escribe docs/briefs/<slug>.md solo si se solicita.
  • Una frase inicial ("Resumen a continuación: N criterios, M preguntas abiertas"), luego el resumen. Nada después.

Criterios de salida

  • Cada criterio de aceptación es observable y se asigna a una comprobación (paso de verificación de flujo, expectativa de prueba de humo o prueba).
  • Nada en el MVP que no se haya solicitado o que no sea estrictamente necesario para lo solicitado.
  • Las preguntas abiertas tienen cada una un valor por defecto, para que se pueda empezar a construir sin esperar.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

iamk3nnyt/claude-skills

Checks UI copy across locales by comparing key parity between next-intl message catalogs and in-code sv/en COPY objects, finding placeholder and array mismatches and words from the other language leaking in (the "och" in English bug), then manually reviewing claims against terms and pricing and the project's banned phrases. Use after editing copy or translations, before shipping a page with new text, or when asked to proofread or check translations.

iamk3nnyt/claude-skills

Applies an agreed visual direction to a page or component by reusing existing components first, then verifies every width and dark mode with the headless-Chrome audit plus a before/after pixel diff, and reviews against Refactoring UI, Nielsen and WCAG 2.2. Use when asked to redesign, restyle, polish or "make it look like the reference", after design-ref or when the direction is already clear.

iamk3nnyt/claude-skills

Extracts the visual system from a reference site or pasted HTML (colour roles, type scale, spacing scale, radii, shadows, button/card/eyebrow anatomy, tone) and maps it onto the current project's existing tokens as a short token table. Use when the user shares a reference ("make it look like <site>", "in this style", a URL or HTML paste) before a redesign.

iamk3nnyt/claude-skills

QAs a project's transactional and digest emails by rendering every template without DB or network, screenshotting at 600 and 375 px in light, dark and images-off, and checking for placeholder leaks (undefined, NaN, {{…}}), preheader, unsubscribe, alt text, absolute links, Outlook-safe buttons, viewport meta and Gmail's 102 KB clip. Use when email templates change, before sending a campaign, or when asked to check how emails look.

Skills relacionados