Communitygithub.com

majiayu000/claude-skill-registry

Una habilidad para analizar y visualizar flujos de código, generando diagramas ASCII claros, diagramas de flujo de datos y análisis tabulares. Ideal para revisar código existente, documentar el diseño de nuevas funcionalidades y redactar documentación técnica.

¿Qué es claude-skill-registry?

Esta habilidad, `majiayu000/claude-skill-registry`, proporciona un conjunto de plantillas reutilizables y metodologías para analizar flujos de código y generar documentación visual. Está diseñada para desarrolladores y agentes de IA (como Claude Code, Cursor o Codex) que necesitan explicar o documentar cómo funciona una funcionalidad, desde la entrada del usuario hasta la salida final. La habilidad se centra en reemplazar descripciones de texto extensas con diagramas ASCII claros, tablas de análisis de datos y diagramas de llamadas en capas. Soporta múltiples escenarios de uso, incluyendo la revisión de código existente, el diseño de nuevas funciones, la preparación para refactorizaciones y la redacción de documentación técnica. Funciona guiando al agente para que identifique primero el objetivo del análisis, seleccione la plantilla adecuada (como un flujo completo, una cadena de llamadas simplificada o un análisis de clases de datos), complete el contenido siguiendo principios de claridad visual y, finalmente, agregue un análisis comparativo (antes/después) para resaltar mejoras. La habilidad también incluye una lista de verificación y advierte sobre antipatrones, como el uso excesivo de texto plano o tablas sin contexto de negocio.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/analysis/code-flow-viz-mmorit00-fund-portfolio-bot-2

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Especificación de Visualización de Flujos de Código

Esta habilidad proporciona un conjunto de plantillas reutilizables y metodologías para analizar flujos de código y generar documentación visual.

Principio fundamental: Explicar claramente con texto y diagramas ASCII "de dónde vienen los datos, por qué capas pasan y a dónde van finalmente".

Cuándo usar

Utilice esta habilidad en los siguientes escenarios:

  • El usuario pregunta "¿cómo funciona esta funcionalidad?"
  • Se necesita diseñar el flujo de datos para una nueva funcionalidad
  • Se requiere analizar la lógica existente antes de una refactorización
  • Se está escribiendo documentación técnica o explicaciones de arquitectura
  • Se necesita visualizar la cadena de llamadas durante una revisión de código

Plantillas principales

1. Diagrama de flujo completo (comparación de múltiples escenarios)

Adecuado para: Analizar múltiples escenarios de uso de una funcionalidad (ej. manual vs automático, éxito vs fallo)

┌─────────────────────────────────────────────────────────────────────┐
│                    Nombre de la funcionalidad (ej. Ciclo de vida    │
│                    de la gestión de límites)                        │
└─────────────────────────────────────────────────────────────────────┘

═══════════════════════════════════════════════════════════════════════
Escenario 1: Nombre del escenario (ej. Consulta automática del estado del límite)
═══════════════════════════════════════════════════════════════════════

  Comando del usuario
     │
     ▼
┌─────────────────────────────────────────────────────────────────┐
│  uv run python -m src.cli.xxx ...                               │
└────────────────┬────────────────────────────────────────────────┘
                 │
                 ▼
        ┌────────────────┐
        │  Capa CLI       │   Llama a la función Flow
        │  _do_xxx()      │ ────────────────────┐
        └────────────────┘                      │
                                                ▼
                                   ┌──────────────────────────┐
                                   │  Capa Flow                │
                                   │  xxx_flow()               │
                                   └───────┬──────────────────┘
                                           │
                                           ▼
                              ┌─────────────────────────────┐
                              │  Capa de Datos               │
                              │  XxxRepo / XxxClient         │
                              └────────┬─────────────────────┘
                                       │
                                       ▼
                          ┌────────────────────────────┐
                          │  Sistema externo / Base de │
                          │  datos (SQLite / API / etc)│
                          └──────────┬─────────────────┘
                                     │ Devuelve datos
                                     ▼
                    ┌──────────────────────────────────┐
                    │  Procesamiento de datos          │
                    │  (análisis/transformación)       │
                    └─────────────┬────────────────────┘
                                  │
                                  ▼
                        ┌──────────────────────┐
                        │  Clase de datos de   │  ← Explicar por qué se mantiene/simplifica
                        │  retorno (Result /   │
                        │  Item / ...)         │
                        └──────────┬───────────┘
                                   │
                                   ▼
                        ┌──────────────────────┐
                        │  Salida formateada   │
                        │  de la capa CLI      │
                        └──────────────────────┘
                                   │
                                   ▼
    ╔══════════════════════════════════════════════════╗
    ║  Ejemplo de salida en terminal                   ║
    ║  (Rodeado con bordes dobles para resaltar        ║
    ║   el efecto visible para el usuario final)       ║
    ╚══════════════════════════════════════════════════╝

═══════════════════════════════════════════════════════════════════════
Escenario 2: Otro escenario
═══════════════════════════════════════════════════════════════════════
(Repetir la estructura anterior, destacando las diferencias)

2. Descripción de la estructura de la tabla de base de datos

Adecuado para: Explicar las tablas de base de datos involucradas en una funcionalidad

CREATE TABLE nombre_tabla (
    id INTEGER PRIMARY KEY AUTOINCREMENT,  -- ← Explicar el propósito de la clave primaria
    campo1 TEXT NOT NULL,                  -- Explicar el significado del campo
    campo2 TEXT,                           -- Significado de NULL en el negocio
    ...
);

-- Índice (explicar por qué es necesario)
CREATE INDEX idx_xxx ON nombre_tabla(campo1, campo2);

Tabla de datos de ejemplo:

idcampo1campo2campo3Descripción
42valor1valor2valor3Explicar el significado de este registro en el negocio
43............

Consultas típicas:

-- Descripción del escenario: ¿Cuándo es necesaria esta consulta?
SELECT * FROM nombre_tabla 
WHERE condicion1 = ? 
  AND (condicion2 IS NULL OR condicion2 >= ?);

3. Diagrama de cadena de llamadas en capas (versión simplificada)

Adecuado para: Explicar rápidamente las relaciones de llamada entre funciones

Capa CLI (_do_xxx)
    │
    └─> Capa Flow (xxx_flow)
            │
            ├─> Datos/Repo (xxx_repo.get)
            │       │
            │       └─> SQLite (SELECT ...)
            │
            └─> Datos/Cliente (xxx_client.fetch)
                    │
                    └─> API externa (HTTP GET ...)

4. Tabla de análisis de diseño de clases de datos

Adecuado para: Evaluar si las clases de datos intermedias son necesarias

Nombre de claseNúmero de camposPropósitoDecisiónMotivo
XxxResult6Agregación de múltiples campos + visualización en CLI✅ MantenerSatisface el "principio de mínima necesidad"
XxxWrapper1Envoltura de un solo campo❌ EliminarEnvoltura excesiva, devolver el tipo original directamente
XxxItem3Elemento de detalle de lista✅ MantenerTiene semántica de negocio

Ejemplo de comparación:

# ❌ Envoltura excesiva
@dataclass
class XxxResult:
    campo: SomeType  # Solo un campo

def xxx_flow() -> XxxResult:
    return XxxResult(campo=valor)

# ✅ Simplificado
def xxx_flow() -> SomeType:  # Devolver directamente
    return valor

5. Anotación de puntos clave del negocio

Adecuado para: Resaltar reglas de negocio y decisiones de diseño

┌─────────────────────────────────────────────────────────────┐
│                    Puntos clave del negocio                 │
├──────────────────────┬──────────────────────────────────────┤
│   ¿Por qué está      │         Decisión específica          │
│   diseñado así?      │                                      │
├──────────────────────┼──────────────────────────────────────┤
│ • Precisión de datos │ Montos con Decimal, 2 decimales      │
│ • Idempotencia       │ Restricción única por (fund_code,    │
│                      │ date)                                │
│ • Trazabilidad       │ record_id como identificador único   │
│                      │ global                               │
└──────────────────────┴──────────────────────────────────────┘

Cómo usar

Paso 1: Determinar el objetivo del análisis

Responda las siguientes preguntas:

  1. ¿Qué funcionalidad quiere entender el usuario?
  2. ¿Cuántos escenarios tiene esta funcionalidad? (éxito/fallo, manual/automático, etc.)
  3. ¿Qué capas están involucradas? (CLI → Flow → Datos → DB/API)
  4. ¿Cuáles son las clases de datos clave? ¿Por qué están diseñadas así?

Paso 2: Seleccionar la plantilla adecuada

  • Comparación de múltiples escenarios → Plantilla 1 (Diagrama de flujo completo)
  • Flujo único → Plantilla 3 (Cadena de llamadas en capas)
  • Diseño de base de datos → Plantilla 2 (Estructura de tabla + datos de ejemplo)
  • Evaluación de clases de datos → Plantilla 4 (Tabla de análisis)

Paso 3: Completar el contenido

Principios:

  • Use diagramas ASCII en lugar de texto extenso
  • Use flechas (│ ▼ ┐ ┘ └ ├ ─) para conectar el flujo de datos
  • Use bordes (┌ ┐ └ ┘ │ ─) para separar capas
  • Use bordes dobles (╔ ╗ ╚ ╝ ║ ═) para resaltar partes visibles para el usuario
  • Agregue comentarios en los nodos clave (← Descripción)

Normas de uso de símbolos:

SímboloPropósitoEjemplo
│ ▼Flujo verticalDatos de arriba a abajo
→ ←Explicación horizontalrecord_id: int ← Clave primaria de BD
┌ ┐ └ ┘Borde simpleRodear bloques de código, comandos
╔ ╗ ╚ ╝Borde dobleResaltar salida de terminal, resultados importantes
═══Línea separadoraSeparar diferentes escenarios

Paso 4: Agregar análisis comparativo

Antes vs Después (escenario de refactorización):

# Antes (versión problemática)
...código...

# Problemas:
# - Envoltura excesiva
# - Campos redundantes
# - Aumenta la carga cognitiva

# Después (versión mejorada)
...código...

# Mejoras:
# - Devuelve directamente tipos significativos
# - Reduce capas intermedias
# - Reduce costos de mantenimiento

Ejemplos reales

Ejemplo 1: Flujo de gestión de límites (versión completa)

(Véase el ejemplo de la Plantilla 1 anterior, desarrolle el flujo completo de 4 escenarios)

Ejemplo 2: Evaluación de clases de datos (módulo fund_restriction)

FunciónRetorno anteriorRetorno actualDecisiónMotivo
add_restrictionAddRestrictionResult(6 campos)Mantener✅La CLI necesita mostrar todos los campos
end_restrictionEndRestrictionResult(4 campos)bool❌Solo necesita éxito/fallo
check_trading_statusCheckStatusResult(2 campos)ParsedRestriction | None❌Envoltura simple

Lista de verificación (Checklist)

Al generar un documento de visualización de flujo, asegúrese de incluir:

  • Resumen de alto nivel (objetivo de la funcionalidad, módulos involucrados)
  • Enumeración de escenarios (éxito/fallo, manual/automático, etc.)
  • Diagrama de flujo en capas (CLI → Flow → Datos → Externo)
  • Estructura de tabla de base de datos (si aplica)
  • Datos de ejemplo y consultas (para ayudar a la comprensión)
  • Explicación de las clases de datos clave (por qué se mantienen/simplifican)
  • Razones de diseño (¿por qué se hizo así?)
  • Puntos de extensión futura (TODO o interfaces reservadas)

Antipatrones (No hacer esto)

❌ Descripción del flujo solo con texto

Primero se llama a la función _do_xxx de la capa CLI, luego _do_xxx llama a la función xxx_flow de la capa Flow,
y xxx_flow llama al método xxx_repo.get de la capa de Datos...

✅ Usar diagramas ASCII

CLI (_do_xxx) → Flow (xxx_flow) → Datos (xxx_repo.get) → SQLite

❌ Tabla sin enfoque

CampoTipo
idint
namestr

✅ Resaltar el significado de negocio

CampoTipoDescripciónRestricción de negocio
idintClave primariaAutogenerado, único global
namestrNombre del fondoNo nulo, para visualización

❌ SQL sin descripción del escenario

SELECT * FROM tabla WHERE id = ?;

✅ Con escenario de negocio

-- Escenario: El usuario consulta los detalles de un registro de restricción
SELECT * FROM fund_restrictions WHERE id = ?;

-- Escenario: Durante el análisis DCA, verificar si una fecha está limitada
SELECT * FROM fund_restrictions
WHERE fund_code = ? AND start_date <= ? AND (end_date IS NULL OR end_date >= ?);

Colaboración con otras habilidades

  • code-style: Seguir las normas de codificación al mostrar ejemplos de código
  • architecture: El diagrama de flujo debe cumplir con las restricciones de la arquitectura en capas
  • dev-workflow: Leer el código y la documentación relevantes antes de analizar el flujo

Resumen

El valor fundamental de esta habilidad:

  1. Plantillas reutilizables: Reduce el tiempo de empezar desde cero
  2. Estilo visual unificado: Diagramas ASCII + tablas + bordes
  3. Perspectiva de negocio: No solo el flujo de código, sino también el "por qué"
  4. Análisis comparativo: Comparación antes/después, múltiples escenarios
  5. Lista de verificación: Asegura que no se omita información clave

Frecuencia de uso: Se puede usar siempre que sea necesario explicar "cómo funciona una funcionalidad".

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados