Habilidades grill-with-docs

📦

grill-with-docs

Name: grill-with-docs
Author: mattpocock

Revisión del contenido r2 Seguro ⚙️ Comandos externos

Cuestiona planes con documentación viva

Los planes de diseño a menudo se alejan del lenguaje del proyecto y de las decisiones registradas. Esta skill cuestiona supuestos, resuelve terminología y actualiza CONTEXT.md o los ADR a medida que las decisiones se consolidan.

Compatible con: Claude Codex Code(CC)

🥉 79 Bronce

Instalar con mi Agente

Copia esta solicitud en tu Agente. Incluye la página canónica del Skill y el manifiesto.

Solicitud de agente

Review the Skillstore skill "grill-with-docs" from https://skillstore.io/skills/mattpocock-grill-with-docs.md and its manifest at https://skillstore.io/api/skills/mattpocock-grill-with-docs/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Tu Agente debe seguir mostrando su plan y solicitar cualquier confirmación exigida por la política de seguridad.

Recursos legibles por agentes

Usa estos enlaces cuando un agente de IA, crawler o script necesite contexto limpio en vez de leer la página completa.

Detalle Markdown GET /skills/mattpocock-grill-with-docs.md Manifest firmado GET /api/skills/mattpocock-grill-with-docs/manifest Lockfile firmado GET /api/skills/mattpocock-grill-with-docs/lockfile

Pruébalo

Usando "grill-with-docs". Quiero añadir cancelación parcial de pedidos a nuestro flujo de pago.

Resultado esperado:

La skill pregunta si la cancelación se aplica a un pedido completo o a líneas de pedido seleccionadas, luego revisa el glosario y el código existentes antes de actualizar CONTEXT.md.

Usando "grill-with-docs". Podríamos reemplazar las llamadas síncronas de facturación con eventos de dominio.

Resultado esperado:

La skill prueba el intercambio, pregunta sobre modos de fallo y límites de propiedad, y luego recomienda si la decisión merece un ADR.

Usando "grill-with-docs". Nuestro equipo usa cuenta, cliente y usuario indistintamente.

Resultado esperado:

La skill identifica la ambigüedad, recomienda términos canónicos y registra los alias evitados después de que el usuario confirma la distinción.

Auditoría de seguridad

Seguro

v5 • 23/7/2026 Abrir el informe versionado

The sole static finding is a false positive because SKILL.md line 7 uses Markdown backticks around slash-command names, not executable shell syntax. The eight-line prompt delegates to two skills and contains no prompt injection or malicious intent.

Archivos escaneados

Líneas analizadas

Elementos de revisión

Falsos positivos ignorados

Factores de riesgo

⚙️ Comandos externos (1)

SKILL.md:7

La auditoría estática y semántica completada más reciente no detectó hallazgos de seguridad confirmados. Esto no demuestra que el skill no tenga efectos secundarios.

Auditado por: codex Ver historial de auditorías →

Compartir y citar este informe

Comparte el informe de evaluación versionado, la insignia neutral, la tarjeta insertable y las citas. Skillstore presenta evidencias sin decidir si este Skill es seguro.

Abrir el informe versionado

Copiar enlace del informe

https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Insignia Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/mattpocock-grill-with-docs/security.svg)](https://skillstore.io/skills/mattpocock-grill-with-docs?utm_source=security_passport_badge)

Insignia HTML

<a href="https://skillstore.io/skills/mattpocock-grill-with-docs?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mattpocock-grill-with-docs/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Tarjeta para insertar

<iframe src="https://skillstore.io/embed/skills/mattpocock-grill-with-docs.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Citas académicas (APA · BibTeX · CFF)

Cita APA

mattpocock. (2026). grill-with-docs security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5

Cita BibTeX

@techreport{mattpocock-mattpocock-grill-with-docs-2026,
  author = {mattpocock},
  title = {grill-with-docs security audit report (audit version 5)},
  institution = {Skillstore},
  year = {2026},
  number = {5},
  url = {https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "grill-with-docs security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
  - name: "mattpocock"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5"
identifiers:
  - type: other
    value: "skillstore:mattpocock-grill-with-docs:audit:5"
    description: "Skillstore immutable audit report identifier"

Puntuación de Skillstore

Por qué esta puntuación Confianza de la evidencia: Alto

Arquitectura

Mantenibilidad

Contenido

Comunidad

Cumplimiento de la especificación

Lo que puedes crear

Aclarar un plan de funcionalidad

Cuestiona una funcionalidad propuesta frente al lenguaje de dominio existente antes de que comience la implementación.

Limpiar términos de dominio

Resuelve términos sobrecargados y registra un vocabulario compartido claro en CONTEXT.md.

Capturar decisiones de arquitectura

Decide si un intercambio de diseño merece un ADR y lo redacta solo cuando aporta valor.

Prueba estos prompts

Revisa mi plan

Cuestiona este plan frente al lenguaje y la documentación del proyecto. Haz una pregunta a la vez y recomienda una respuesta para cada pregunta.

Resolver términos de dominio

Revisa estos términos en busca de ambigüedad. Compáralos con CONTEXT.md y propón nombres canónicos donde el lenguaje entre en conflicto.

Comprobar el código frente a las afirmaciones

Creo que el sistema se comporta de esta manera. Revisa el código y la documentación existente, luego cuestiona cualquier contradicción antes de que decidamos.

Guiar una decisión de ADR

Ayuda a decidir si este intercambio necesita un ADR. Verifica que sea difícil de revertir, sorprendente y basado en alternativas reales.

Mejores prácticas

Empieza con un plan concreto o una pregunta de dominio, no con una solicitud amplia de comentarios.
Deja que la skill inspeccione los archivos CONTEXT.md y ADR existentes antes de nombrar nuevos conceptos.
Confirma cada decisión terminológica antes de permitir actualizaciones de documentación.

Evitar

Usar la skill para crear ADR para decisiones de implementación reversibles o rutinarias.
Aceptar nuevos términos de dominio sin revisar primero el lenguaje existente.
Agrupar muchas decisiones sin resolver en un solo prompt sin responder las preguntas anteriores.

Preguntas frecuentes

¿En qué ayuda esta skill?

Cuestiona planes de software frente al lenguaje del proyecto, el comportamiento del código, CONTEXT.md y los registros de decisiones de arquitectura.

¿Escribe código?

No. Se centra en planificación, terminología, actualizaciones de CONTEXT.md y creación de ADR cuando corresponde.

¿Puede crear nuevos archivos de documentación?

Sí. La skill crea CONTEXT.md o archivos docs/adr de forma diferida cuando una decisión confirmada necesita registrarse.

¿Cuándo debería usarla?

Úsala antes de implementar una funcionalidad significativa, cambiar el lenguaje de dominio o tomar una decisión de arquitectura duradera.

¿Cómo maneja múltiples contextos?

Usa CONTEXT-MAP.md cuando está presente y luego pregunta cuando el contexto relevante no está claro.

¿Qué asistentes pueden usarla?

El informe enumera soporte para Claude, Codex y Claude Code.

Detalles del desarrollador

Autor

mattpocock

Licencia

MIT

Revisión de Skillstore

Aviso de versión

El autor no declaró una versión.

Repositorio

https://github.com/mattpocock/skills/tree/main/skills/engineering/grill-with-docs/

Ref.

ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006

Actualidad del mantenimiento

25/7/2026

Uso

44 descargas · 90 vistas

Estructura de archivos

📄 SKILL.md