| name | file_read_and_summarize |
| description | Read and understand file content with automatic summarization for large files |
| version | 1.0.0 |
| author | Hive Team |
| icon | 📄 |
| category | filesystem |
| permissions | ["filesystem_read"] |
| dependencies | [] |
| tools | ["project_read"] |
| triggers | ["leé este archivo","read this file","mostrame el contenido","show content","qué dice este archivo","resumí este archivo","summarize this file","entendé este código","understand this code"] |
| preferred_agents | [] |
| steps | [{"step":1,"action":"project_exists","instruction":"Verify file exists before attempting to read","output":"exists_boolean"},{"step":2,"action":"project_read","instruction":"Read file content. Use offset/limit for large files (>1000 lines)","params":{"path":"file path","offset":0,"limit":100},"output":"file_content"},{"step":3,"action":"synthesize","instruction":"Summarize content if file is large. Extract key information relevant to user request","output":"summary"}] |
| rules | ["Always check file exists with project_exists before reading","Use offset and limit for files >1000 lines to avoid context saturation","Read in chunks for very large files — iterate with offset","Summarize automatically for files >500 lines unless user requests full content","Identify file type by extension and adapt summary format (code vs text vs config)"] |
| output_format | {"structure":"markdown","sections":["file_path","file_type","line_count","summary","key_points"],"max_length":"500 words for summary, full content if requested"} |
| examples | [{"user_input":"leé el archivo package.json","expected_behavior":"Check exists → project_read({ path: 'package.json' }) → return full content (small file)"},{"user_input":"resumí el archivo src/main.ts","expected_behavior":"project_read with offset/limit → identify main exports and functions → summarize structure"},{"user_input":"qué dice este archivo de configuración","expected_behavior":"project_read → parse config format → explain key settings in plain language"}] |
File Read and Summarize Skill
Cuándo se Activa
Esta skill se activa cuando el usuario necesita leer y entender el contenido de un archivo, especialmente cuando:
- El archivo es grande y necesita resumen
- Se requiere comprensión del contenido (no solo lectura)
- El usuario pide "qué dice", "resumí", "entendé"
Herramientas Disponibles
| Tool | Qué hace | Cuándo usarla |
|---|
project_read | Lee contenido de archivo del workspace | Lectura de cualquier archivo |
Workflow
- Verificar existencia →
project_exists({ path })
- Leer contenido →
project_read({ path, offset, limit })
- Sintetizar → Resumir si es grande, extraer puntos clave
Mejores Prácticas
- Para archivos >1000 líneas, usar
offset y limit
- Identificar tipo de archivo por extensión y adaptar formato de resumen
- Para código: identificar funciones, clases, exports principales
- Para config: explicar settings clave en lenguaje simple
- Para texto: extraer ideas principales
Errores a Evitar
- ❌ Leer sin verificar existencia
- ❌ Retornar archivo completo sin resumir si es muy grande
- ❌ No identificar tipo de archivo para adaptar resumen