Skills Agentes

Api Docs

Genera documentación de API a partir del código fuente, con soporte para JSDoc y OpenAPI.

Solicitabash(npx *) mcp__plugin_ruflo-core_ruflo__hooks_worker-dispatch read write grep
Estrellas
69.4k

en todo el repo

Actividad
54

0–100, la ruta de este skill

Actualizado
el mes pasado

último commit aquí

Commits
1

últimos 90 días

Contexto
239 tok

19 tok en reposo

Paquete
1 archivo

955 B

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add ruvnet/ruflo --skill api-docs --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Escanea las funciones, clases e interfaces públicas exportadas en código TypeScript/JavaScript.
  • Extrae anotaciones JSDoc (@param, @returns, @throws, @example) y añade JSDoc a las APIs públicas sin documentar.
  • Genera definiciones OpenAPI 3.0 para endpoints HTTP.

Úsalo cuando

  • Al documentar los exports públicos de un módulo TypeScript/JavaScript.
  • Al generar una spec OpenAPI para endpoints HTTP existentes.

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • Genera la documentación de la API en src/api
    • Añade JSDoc a las funciones públicas sin documentar

    SKILL.md

    En inglés

    Generate API documentation from TypeScript/JavaScript source:

    1. Scan exports: Find all public functions, classes, and interfaces
    2. Extract JSDoc: Parse @param, @returns, @throws, @example annotations
    3. Generate missing docs: Add JSDoc for undocumented public APIs
    4. OpenAPI spec: For HTTP endpoints, generate OpenAPI 3.0 definitions

    Dispatch via MCP: mcp__plugin_ruflo-core_ruflo__hooks_worker-dispatch({ trigger: "document", scope: "api" })

    Conventions:

    • Every public export must have a JSDoc comment
    • Include @param with type and description
    • Include @returns with type and description
    • Include @throws for known error conditions
    • Include @example for non-obvious usage

    Reproducido de ruvnet/ruflo bajo licencia MIT. Leer esta página en markdown.

    Archivos

    1 archivo en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Detalles

    Creador
    ruvnet
    Categoría
    Documentos
    Licencia
    MIT
    Recursos incluidos
    Solo SKILL.md
    Repositorio
    ruvnet/ruflo
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de ruvnet/ruflo

    Este repo incluye 275 skills. Si instalas uno, normalmente ya tienes los demás.

    Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución.

    Costo de contexto al activarse
    833 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 4 días
    Permisos
    herramientas desarrollo

    Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde.

    Costo de contexto al activarse
    627 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 4 días
    Permisos
    automatizacion

    Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento.

    Costo de contexto al activarse
    566 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 4 días
    Permisos
    automatizacion

    Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP.

    Costo de contexto al activarse
    866 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 27 días
    herramientas desarrollo

    Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado.

    Costo de contexto al activarse
    443 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 26 días
    devops infraestructura

    Ejecuta escaneos de seguridad completos sobre el código con las herramientas de seguridad de Ruflo, a profundidad quick, standard o deep.

    Costo de contexto al activarse
    298 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    el mes pasado
    seguridad