📦

api-designer

Name: api-designer
Author: AutumnsGrove

Revisión del contenido r3 Seguro ⚙️ Comandos externos🌐 Acceso a red🔑 Variables de entorno📁 Acceso al sistema de archivos

Diseña APIs REST y GraphQL confiables

Los equipos de API necesitan endpoints, autenticación y documentación coherentes. Esta skill guía decisiones de diseño sobre REST, GraphQL, OpenAPI, versionado y seguridad.

Compatible con: Claude Codex Code(CC)

🥇 84 Oro

Maintain this Skill? Claim it 🥇 84 Oro

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 "api-designer" from https://skillstore.io/skills/autumnsgrove-api-designer.md and its manifest at https://skillstore.io/api/skills/autumnsgrove-api-designer/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/autumnsgrove-api-designer.md Manifest firmado GET /api/skills/autumnsgrove-api-designer/manifest Lockfile firmado GET /api/skills/autumnsgrove-api-designer/lockfile

Pruébalo

Usando "api-designer". Diseña una API de blog con usuarios, publicaciones, comentarios y etiquetas.

Resultado esperado:

Mapa de recursos para usuarios, publicaciones, comentarios y etiquetas.
Plan de endpoints con métodos, códigos de estado, paginación y filtrado.
Recomendaciones de autenticación y autorización para acciones públicas y privadas.

Usando "api-designer". Planifica el versionado para una API que cambiará el nombre de campos de cliente.

Resultado esperado:

Recomendación de una nueva versión mayor porque los clientes verán cambios incompatibles en los campos.
Cronograma de obsolescencia con encabezados de advertencia, guía de migración y periodo de soporte paralelo.
Lista de verificación de compatibilidad para SDKs, documentación, monitoreo y comunicación con clientes.

Usando "api-designer". Revisa una API que expone claves de API en parámetros de consulta.

Resultado esperado:

Preocupación de seguridad sobre la exposición en logs y el historial del navegador.
Recomendación de usar encabezados de autorización y claves con alcance limitado.
Actualización de documentación para rotación, expiración y registro de uso.

Auditoría de seguridad

Seguro

v14 • 23/7/2026 Abrir el informe versionado

All 146 static findings are false positives caused by Markdown syntax, example URLs and credentials, validation text, and intended local file output. The Python helper does not spawn commands, read environment variables, access certificate files, or make network requests. No prompt injection, exfiltration intent, or other semantic security issue was found.

Archivos escaneados

5,100

Líneas analizadas

Elementos de revisión

Falsos positivos ignorados

Factores de riesgo

⚙️ Comandos externos (50)

examples/openapi_spec.yaml:760 scripts/api_helper.py:230 scripts/api_helper.py:238 scripts/api_helper.py:262 scripts/api_helper.py:270 scripts/api_helper.py:277 SKILL.md:65-81 SKILL.md:81-88 SKILL.md:88 SKILL.md:89 SKILL.md:92-95 SKILL.md:95-105 SKILL.md:105-124 SKILL.md:124 SKILL.md:125 SKILL.md:128-140 SKILL.md:140-147 SKILL.md:147-162 SKILL.md:162-165 SKILL.md:165-166 SKILL.md:166-167 SKILL.md:167-168 SKILL.md:168-169 SKILL.md:169-170 SKILL.md:170-171 SKILL.md:171-172 SKILL.md:172-173 SKILL.md:173-174 SKILL.md:174-179 SKILL.md:179-190 SKILL.md:190-193 SKILL.md:193-205 SKILL.md:205-207 SKILL.md:207-215 SKILL.md:215-234 SKILL.md:234-240 SKILL.md:240-258 SKILL.md:258-264 SKILL.md:264-281 SKILL.md:281-283 SKILL.md:283-290 SKILL.md:290-296 SKILL.md:296-299 SKILL.md:299-306 SKILL.md:306-309 SKILL.md:309-313 SKILL.md:313-318 SKILL.md:318-329 SKILL.md:329-332 SKILL.md:332-334

🌐 Acceso a red (37)

🔑 Variables de entorno (4)

references/authentication.md:287 references/common-patterns.md:175 references/rest_best_practices.md:626 SKILL.md:515

📁 Acceso al sistema de archivos (2)

scripts/api_helper.py:75 scripts/api_helper.py:288

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/autumnsgrove-api-designer/audits/14?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Insignia Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/autumnsgrove-api-designer/security.svg)](https://skillstore.io/skills/autumnsgrove-api-designer?utm_source=security_passport_badge)

Insignia HTML

<a href="https://skillstore.io/skills/autumnsgrove-api-designer?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/autumnsgrove-api-designer/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Tarjeta para insertar

<iframe src="https://skillstore.io/embed/skills/autumnsgrove-api-designer.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

AutumnsGrove. (2026). api-designer security audit report (audit version 14) [Author version unspecified]. Skillstore. https://skillstore.io/skills/autumnsgrove-api-designer/audits/14

Cita BibTeX

@techreport{autumnsgrove-autumnsgrove-api-designer-2026,
  author = {AutumnsGrove},
  title = {api-designer security audit report (audit version 14)},
  institution = {Skillstore},
  year = {2026},
  number = {14},
  url = {https://skillstore.io/skills/autumnsgrove-api-designer/audits/14},
  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: "api-designer security audit report (audit version 14)"
version: "unspecified"
type: report
authors:
  - name: "AutumnsGrove"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/autumnsgrove-api-designer/audits/14"
identifiers:
  - type: other
    value: "skillstore:autumnsgrove-api-designer:audit:14"
    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

Diseñar un nuevo contrato de servicio

Define recursos REST, payloads, códigos de estado, paginación y respuestas de error antes de que comience la implementación.

Planificar el versionado y la obsolescencia de API

Elige una estrategia de versionado, documenta cambios incompatibles y prepara orientación de migración para los equipos cliente.

Crear documentación para desarrolladores

Convierte decisiones sobre endpoints en esquemas OpenAPI, notas de autenticación, ejemplos y documentación de referencia legible.

Prueba estos prompts

Diseñar una API REST básica

Diseña una API REST para [product]. Incluye recursos principales, métodos, códigos de estado, paginación y respuestas de error.

Crear un esquema OpenAPI

Crea un esquema OpenAPI para [service]. Incluye servidores, rutas, esquemas, esquemas de seguridad y respuestas de ejemplo.

Planificar autenticación y versionado

Recomienda autenticación, autorización, limitación de tasa y versionado para [API]. Explica compensaciones y riesgos de migración.

Revisar un contrato de API existente

Revisa este contrato de API en cuanto a coherencia, seguridad, compatibilidad hacia atrás, manejo de errores y brechas de documentación: [details].

Mejores prácticas

Empieza con recursos, permisos, propiedad de datos y comportamiento de errores antes de escribir los detalles de endpoints.
Mantén los ejemplos de OpenAPI, las reglas de autenticación y las notas de versionado sincronizados con los cambios de implementación.
Revisa las especificaciones generadas con los equipos de seguridad, plataforma y clientes antes del lanzamiento público.

Evitar

No coloques secretos, tokens ni claves de API en URLs, logs o ejemplos públicos.
No versiones APIs por campos opcionales aditivos ni correcciones de errores.
No publiques códigos de estado no documentados, errores incoherentes ni endpoints de listas sin límites.