Agent-Skills.md

Agent Skills: 📂 Filesystem as Extended Context

Uso del sistema de archivos como extensión de la ventana de contexto, persistencia de planes, comunicación entre sub-agentes y carga dinámica de habilidades.

UncategorizedID: yuniorglez/gemini-elite-core/filesystem-context

Repository

yuniorglez/gemini-elite-core
YuniorGlez
96

Install this agent skill to your local

pnpm dlx add-skill https://github.com/YuniorGlez/gemini-elite-core/tree/HEAD/skills/filesystem-context

Skill Files

Browse the full folder contents for filesystem-context.

Download Skill

Loading file tree…

skills/filesystem-context/SKILL.md

Skill Metadata

Name
filesystem-context
Description
Uso del sistema de archivos como extensión de la ventana de contexto, persistencia de planes, comunicación entre sub-agentes y carga dinámica de habilidades.

📂 Filesystem as Extended Context

Esta habilidad permite utilizar el sistema de archivos local como una capa de memoria persistente y extendida. El objetivo es descargar información verbosa o estática (logs, planes detallados, documentación masiva) fuera de la ventana de contexto activa, manteniendo solo referencias de alta señal.

Mental Model: El sistema de archivos es el "disco duro" del agente, mientras que el contexto es la "RAM". Optimizar el flujo entre ambos maximiza la capacidad de razonamiento sin saturar la atención.

🚩 Fragilidad y Autonomía

  • Fragilidad: Baja. El sistema de archivos es un medio estable y confiable.
  • Libertad: Muy Alta en la organización de directorios y formatos de persistencia.

🚀 Cuándo Activar

  • En sesiones de depuración con salidas de terminal masivas.
  • Al coordinar tareas complejas entre múltiples sub-agentes.
  • Para mantener planes de ejecución de larga duración que sobrevivan a reinicios de sesión.
  • Al implementar sistemas de auto-modificación o aprendizaje de preferencias.

🧠 Conceptos Core

1. El Patrón Scratchpad

Usa archivos temporales (.scratch, plans/) para anotar ideas, borradores de código o resultados de investigación antes de integrarlos en la solución final.

2. Offloading de Observaciones

Mueve salidas de herramientas verbosas (ej. npm test con 1000 líneas) a un archivo y proporciona al modelo un resumen y el path.

3. Persistencia de Planes (Stateful Agents)

Guarda el estado actual del plan en un archivo YAML/Markdown para que el agente (o uno nuevo) pueda retomar exactamente donde se quedó.

🛠️ Implementación en Gemini Elite Core

Patrón: Directorio de Trabajo Estructurado

Define una jerarquía clara para que el agente sepa dónde buscar cada tipo de "memoria".

.gemini/
├── scratch/          # Archivos efímeros de trabajo
├── plans/            # Planes de tareas activos
├── agents/           # Workspaces de sub-agentes
└── preferences.yaml  # Preferencias aprendidas

Patrón: Dynamic Skill Loading

No cargues todas las habilidades al inicio. Carga el SKILL.md completo solo cuando el agente detecte que es relevante para la tarea actual.

<OFFLOADED_CONTEXT>
- Skill: advanced-evaluation (Path: skills/advanced-evaluation/SKILL.md)
- Reason: User requested LLM-as-a-Judge implementation.
</OFFLOADED_CONTEXT>

🔗 Integraciones

  • context-optimization: El filesystem es la herramienta principal para la "compactación" de contexto.
  • multi-agent-patterns: Uso de workspaces compartidos para comunicación asíncrona.
  • project-development: Tracking de hitos y progreso en archivos de proyecto.

📚 Referencias Internas

  • references/implementation-patterns.md: Librería de clases y scripts para ScratchPad, PlanPersistence y Workspaces.