Habilidades openai-docs-skill
📚

openai-docs-skill

Seguro ⚙️ Comandos externos🌐 Acceso a red📁 Acceso al sistema de archivos

Acceder a los Documentos de Desarrollador de OpenAI

Obtén documentación actualizada de la API de OpenAI directamente en tu flujo de trabajo de IA. Esta habilidad consulta el servidor MCP oficial de OpenAI Docs para obtener referencias precisas y actuales de todas las APIs, SDKs y herramientas de OpenAI.

Soporta: Claude Codex Code(CC)
📊 71 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "openai-docs-skill". search "Responses API" 5

Resultado esperado:

Devuelve JSON con 5 resultados de búsqueda de los documentos de OpenAI, cada uno con título, URL y puntuación de relevancia

Usando "openai-docs-skill". fetch https://platform.openai.com/docs/guides/migrate-to-responses

Resultado esperado:

Devuelve contenido markdown de la guía de migración con instrucciones paso a paso y ejemplos de código

Usando "openai-docs-skill". openapi https://api.openai.com/v1/responses python,javascript code-only

Resultado esperado:

Devuelve ejemplos de código en Python y JavaScript para llamar al endpoint de la Responses API

Auditoría de seguridad

Seguro
v1 • 3/4/2026

This is a legitimate documentation access skill. Static analyzer flagged 44 potential issues, but evaluation confirms all are false positives. The script uses jq for safe JSON construction, makes read-only HTTP requests to OpenAI's official MCP server, and performs standard filesystem checks. No malicious intent or security vulnerabilities identified.

2
Archivos escaneados
224
Líneas analizadas
7
hallazgos
1
Auditorías totales

Problemas críticos (1)

False Positive: Weak Cryptographic Algorithm
Static analyzer incorrectly flagged 'weak cryptographic algorithm' at SKILL.md:3 and SKILL.md:23. Line 3 is YAML frontmatter (description field), line 23 is a bash command example. No cryptographic code exists in this skill.
Problemas de riesgo medio (1)
Shell Command Execution in Script
Script uses jq for JSON construction. While this involves shell commands, arguments are properly sanitized using --arg and --argjson flags which prevent injection. This is standard practice for CLI tools.
Problemas de riesgo bajo (2)
HTTP Requests to External Endpoint
Script makes HTTP requests to https://developers.openai.com/mcp which is OpenAI's official documentation MCP server. This is the intended functionality of the skill.
Filesystem Command Checks
Script uses command -v to verify required tools (curl, jq) are installed. Standard shell practice.
Auditado por: claude

Puntuación de calidad

45
Arquitectura
100
Mantenibilidad
87
Contenido
50
Comunidad
76
Seguridad
91
Cumplimiento de la especificación

Lo que puedes crear

Implementación de API

Al implementar funciones de la API de OpenAI, consulta rápidamente esquemas de parámetros, límites de tasa y formatos de respuesta

Asistencia de Migración

Obtén guías de migración paso a paso al cambiar entre versiones o endpoints de la API de OpenAI

Referencia de SDK

Accede a documentación específica del SDK para Python, Node.js y otros lenguajes soportados

Prueba estos prompts

Búsqueda Básica de API
Usa la habilidad openai-docs-skill para encontrar documentación sobre la [Responses API / Chat Completions API / Realtime API]. Muéstrame la URL del endpoint, parámetros de solicitud y formato de respuesta.
Detalles de Parámetros
Busca el parámetro [temperature, max_tokens, stream] en la documentación de OpenAI. Incluye la descripción del parámetro, valores válidos y configuración predeterminada.
Guía de Migración
Encuentra la guía de migración para pasar de [Chat Completions a Responses API]. ¿Cuáles son las principales diferencias y qué cambios de código se necesitan?
Ejemplos de Código
Obtén un ejemplo de código para llamar a la [Assistants API] usando el SDK de [Python / Node.js]. Incluye la configuración de autenticación y uso básico.

Mejores prácticas

  • Siempre incluye la URL de origen en tu respuesta al usar documentación de esta habilidad
  • Usa consultas de búsqueda específicas para obtener resultados más relevantes
  • Verifica la fecha de la URL del documento para confirmar que tienes información actualizada
  • Usa el parámetro de ancla para enlazar directamente a secciones específicas

Evitar

  • Confiar en la memoria en lugar de verificar los documentos oficiales para parámetros actuales
  • Usar tutoriales desactualizados en lugar de la documentación oficial
  • Ignorar los límites de tasa y el manejo de errores documentados en los documentos
  • No verificar que las versiones de API coincidan con la documentación que estás leyendo

Preguntas frecuentes

¿Cómo uso esta habilidad?
Usa el envoltorio CLI en scripts/openai-docs-mcp.sh con subcomandos como search, fetch, list u openapi. La habilidad consultará automáticamente el servidor MCP de documentación oficial de OpenAI.
¿Qué fuentes de documentación access?
Esta habilidad se conecta al servidor MCP oficial de OpenAI en developers.openai.com/mcp, proporcionando acceso a toda la documentación pública de la API de OpenAI, guías de SDKs y documentos de migración.
¿Necesito alguna dependencia?
Sí, esta habilidad requiere que curl y jq estén instalados en tu sistema. Estos se usan para realizar solicitudes HTTP y procesar respuestas JSON.
¿Puede esta habilidad realizar llamadas API a OpenAI?
No, esta habilidad solo accede a documentación. No realiza llamadas a las APIs de chat o completion de OpenAI. Solo consulta el servidor MCP de documentación.
¿Con qué frecuencia se actualiza la documentación?
La habilidad obtiene documentación en vivo de los servidores de OpenAI, por lo que siempre obtienes la versión actual. Verifica la URL del documento o busca información de versión en el contenido.
¿Puedo obtener ejemplos de código en lenguajes específicos?
Sí, usa el subcomando openapi con parámetros de lenguaje. Por ejemplo: openapi <url> python,javascript code-only devolverá ejemplos de código en ambos lenguajes.

Detalles del desarrollador

Estructura de archivos