agentsclimarketplace

Documentador

Skill Vasallo94/skill-issue/skills/obsidian/documentador

A curated marketplace of open Agent Skills (SKILL.md) — the real skills I use day to day, compatible with the open skills ecosystem.

Install
npx -y skills add Vasallo94/skill-issue --skill documentador

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Genera documentacion de proyectos de codigo analizando el repositorio. Agnostico al lenguaje. Agrupa por modulo/concepto, no por archivo. NUNCA inventa descripciones.

SKILL.md

2.7 KB, as published. Nobody here has run it

Documentador de Proyectos

Skill para generar documentacion de proyectos de codigo extrayendo informacion UNICAMENTE del codigo fuente. Agnostica al lenguaje.

Cuando usar esta skill

Cuando el usuario quiera documentar un proyecto de codigo en el vault: generar una wiki/base de conocimiento a partir del repositorio.

[!CAUTION] Antes de crear o editar notas, lee las [[.agents/REGLAS_GLOBALES|Reglas Globales]].

Principios fundamentales

  1. DOCUMENTA SOLO LO QUE EXISTE: no inventes descripciones. Si no hay docstring, escribe [Sin documentar].
  2. AGRUPA POR CONCEPTO, NO POR ARCHIVO: 6 archivos de agentes = 1 nota "Agentes", no 6 notas.
  3. DIAGRAMAS EN MERMAID: usa la skill diagrama-arquitectura para cualquier diagrama. Nunca ASCII art.

Proceso

  1. Preguntar la ruta del repositorio
  2. Escanear estructura con Glob y Grep
  3. Identificar componentes logicos (agrupar archivos relacionados)
  4. Mostrar plan al usuario y esperar confirmacion
  5. Crear UNA nota por componente en 02_Proyectos/<proyecto>/

Plan de documentacion

Objetivo: ~5-10 notas por proyecto, no 50+. Ejemplo:

55 archivos -> 6 notas:
  - Indice (arquitectura general)
  - Agente Principal (archivos de agente)
  - API (endpoints y servidor)
  - Core (logica de negocio)
  - Utilidades (helpers, config)
  - Pipeline (flujo de datos)

Estructura de nota de componente

---
title: "Componente - Nombre"
type: doc-proyecto
status: completo
tags: [nombre-proyecto]
source_files: [archivo1.py, archivo2.py]
created: 2026-06-09
updated: 2026-06-09
---

Secciones:

  • Vision general del componente
  • Clases/funciones principales (tabla con nombre, descripcion, parametros)
  • Esquemas/modelos de datos
  • Dependencias externas

Estructura del indice

---
title: "Proyecto - Nombre"
type: proyecto
status: completo
tags: [nombre-proyecto]
repo: "https://..."
stack: [lenguaje, frameworks]
created: 2026-06-09
updated: 2026-06-09
---

Secciones:

  • Vision general de la arquitectura
  • Tabla de componentes (nombre, descripcion, notas del vault)
  • Dependencias externas
  • Diagrama Mermaid de la arquitectura

Alcance de extraccion

Incluir: clases principales, metodos publicos, esquemas/modelos, funciones de entrada, docstrings literales, imports externos.

Excluir: funciones privadas (_), imports internos triviales, constantes obvias, __init__.py vacios, tests/, migrations/.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.