Communitygithub.com

JantonioFC/skillsbank

Registra cambios técnicos con registros estructurados, una máquina de estados y transferencia de sesiones. Uso: /tc <init|create|update|status|resume|close|export|dashboard> [argumentos]

¿Qué es skillsbank?

Este skill permite a un agente de IA (como Claude Code, Cursor o Codex) rastrear cambios técnicos en un proyecto de software de manera estructurada y auditable. Proporciona un conjunto de comandos (prefijo /tc) para iniciar el seguimiento, crear y actualizar registros de cambios técnicos (TC), consultar su estado, reanudar sesiones previas, cerrar cambios desplegados y validar el registro completo. Es útil para equipos de desarrollo que necesitan mantener un historial detallado de modificaciones, con soporte para una máquina de estados que guía cada TC desde su creación hasta el despliegue, asegurando que no se omitan pasos y que todos los cambios queden documentados. El skill se apoya en scripts Python almacenados en la ruta `engineering/tc-tracker/scripts/` y se integra directamente en el flujo de trabajo del agente, minimizando la sobrecarga administrativa.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/skills/tc

Preguntar en tu IA favorita

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

Documentación

/tc — Seguimiento de Cambios Técnicos

Envía un comando TC (Cambio Técnico). Argumentos: $ARGUMENTS.

Si $ARGUMENTS está vacío, imprime este menú y se detiene:

/tc init                       Inicia el seguimiento de TC en este proyecto
/tc create <nombre>            Crea un nuevo registro de TC
/tc update <id-tc> [...]       Actualiza campos, estado, archivos, transferencia
/tc status [id-tc]             Muestra un TC o el resumen del registro
/tc resume <id-tc>             Reanuda un TC de una sesión anterior
/tc close <id-tc>              Transiciona un TC a desplegado
/tc export                     Vuelve a renderizar artefactos derivados
/tc dashboard                  Vuelve a renderizar el resumen del registro

De lo contrario, analiza $ARGUMENTS como <subcomando> <resto> y envía al protocolo correspondiente a continuación. Todos los scripts están en engineering/tc-tracker/scripts/.

Subcomandos

init

  1. Ejecuta:
    python3 engineering/skills/tc-tracker/scripts/tc_init.py --root . --json
    
  2. Si el estado es already_initialized, informa las estadísticas actuales y se detiene.
  3. De lo contrario, informa qué se creó y sugiere /tc create <nombre> como siguiente paso.

create <nombre>

  1. Analiza <nombre> como un slug en kebab-case. Si falta, pide uno al usuario.
  2. Pregunta al usuario (una pregunta a la vez) por:
    • Título (5-120 caracteres)
    • Alcance: feature | bugfix | refactor | infrastructure | documentation | hotfix | enhancement
    • Prioridad: critical | high | medium | low (por defecto medium)
    • Resumen (10+ caracteres)
    • Motivación
  3. Ejecuta:
    python3 engineering/skills/tc-tracker/scripts/tc_create.py --root . \
      --name "<slug>" --title "<título>" --scope <alcance> --priority <prioridad> \
      --summary "<resumen>" --motivation "<motivación>" --json
    
  4. Informa el nuevo ID de TC y la ruta al registro.

update <id-tc> [intención]

  1. Si falta <id-tc>, lista los TC activos (estado in_progress o blocked) desde tc_status.py --all y pregunta cuál.
  2. Determina la intención del usuario a partir del lenguaje natural:
    • Cambio de estado → --set-status <estado> con --reason "<por qué>"
    • Agregar archivos → uno o más --add-file ruta[:acción]
    • Agregar una prueba → --add-test "<título>" --test-procedure "<paso>" --test-expected "<resultado>"
    • Actualizar transferencia → cualquier combinación de --handoff-progress, --handoff-next, --handoff-blocker, --handoff-context
    • Agregar una nota → --note "<texto>"
    • Agregar una etiqueta → --tag <etiqueta>
  3. Ejecuta:
    python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <id-tc> [banderas] --json
    
  4. Si el código de salida no es cero, muestra el error textualmente. La máquina de estados y el validador rechazarán movimientos no válidos; no reintentes a ciegas.

status [id-tc]

  • Si se proporciona <id-tc>:
    python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --tc-id <id-tc>
    
  • De lo contrario:
    python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --all
    

resume <id-tc>

  1. Ejecuta:
    python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --tc-id <id-tc> --json
    
  2. Muestra el bloque de transferencia de forma prominente: progress_summary, next_steps (numerados), blockers, key_context.
  3. Pregunta: "¿Reanudar y continuar con el siguiente paso 1? (s/n)"
  4. Si la respuesta es sí, ejecuta una actualización para registrar la reanudación:
    python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <id-tc> \
      --note "Sesión reanudada" --reason "transferencia de sesión"
    
  5. Comienza a ejecutar el primer elemento de next_steps. NO vuelvas a derivar el contexto — confía en la transferencia.

close <id-tc>

  1. Lee el registro mediante tc_status.py --tc-id <id-tc> --json.
  2. Verifica que el estado actual sea tested. Si no lo es, rechaza e indica al usuario qué transiciones aún son necesarias.
  3. Revisa test_cases: advierte si alguno está pending, fail o blocked.
  4. Pregunta al usuario:
    • "¿Quién aprueba? (tu nombre, o 'self')"
    • "Notas de aprobación (opcional):"
    • "Estado de cobertura de pruebas: none / partial / full"
  5. Ejecuta:
    python3 engineering/skills/tc-tracker/scripts/tc_update.py --root . --tc-id <id-tc> \
      --set-status deployed --reason "Aprobado por <aprobador>" --note "Aprobación: <aprobador> — <notas>"
    
    Luego edita directamente el bloque de approval mediante una actualización de seguimiento si tu versión del script lo soporta; de lo contrario, instruye al usuario para que registre la aprobación en notes.
  6. Informa: "TC-NNN cerrado y desplegado."

export

No hay exportación automática a HTML en este skill. En su lugar, vuelve a validar todo:

  1. Lee el registro.
  2. Para cada registro, ejecuta:
    python3 engineering/skills/tc-tracker/scripts/tc_validator.py --record <ruta> --json
    
  3. Ejecuta:
    python3 engineering/skills/tc-tracker/scripts/tc_validator.py --registry docs/TC/tc_registry.json --json
    
  4. Informa: total de registros validados, errores encontrados, rutas a cualquier registro no válido.

dashboard

Ejecuta el resumen de todos los registros:

python3 engineering/skills/tc-tracker/scripts/tc_status.py --root . --all

Reglas de Hierro

  1. Nunca edites tc_record.json manualmente. Usa siempre tc_update.py para que se añada el historial de revisiones y se ejecute la validación.
  2. Nunca te saltes la máquina de estados. Avanza paso a paso a través de los estados aunque parezca redundante.
  3. Nunca elimines un TC. El historial es de solo añadido — agrega una revisión final y etiquétala como [CANCELLED].
  4. Contabilidad en segundo plano. Cuando estés en medio de una tarea, lanza un subagente en segundo plano para actualizar el TC. No pauses la codificación para hacer papeleo.
  5. Valida antes de informar éxito. Si un script sale con código distinto de cero, muestra el error y detente.

Skills Relacionados

  • engineering/tc-tracker — SKILL.md completo con referencia del esquema, diagramas del ciclo de vida y el formato de transferencia.
  • engineering/changelog-generator — Combínalo con el rastreador de TC: los TC sirven para el registro de auditoría por cambio, y el changelog para las notas de lanzamiento orientadas al usuario.
  • engineering/tech-debt-tracker — Para rastrear deuda técnica de larga duración en lugar de cambios de código discretos.

Individual skills in this repo

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

JantonioFC/skillsbank

AI-powered image editing with style transfer and object removal

JantonioFC/skillsbank

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

JantonioFC/skillsbank

Analise e auditoria de editais de leilao judicial e extrajudicial. Riscos ocultos, clausulas perigosas, debitos, ocupante e classificacao da oportunidade.

JantonioFC/skillsbank

Embed Photopea in web apps using photopea.js. Covers embedding, file I/O, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.

JantonioFC/skillsbank

Best practices for Remotion - Video creation in React

JantonioFC/skillsbank

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

JantonioFC/skillsbank

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

JantonioFC/skillsbank

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

JantonioFC/skillsbank

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

JantonioFC/skillsbank

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

JantonioFC/skillsbank

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

JantonioFC/skillsbank

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

JantonioFC/skillsbank

Tool lifecycle UI components for React/Next.js from ui.inference.sh. Display tool calls: pending, progress, approval required, results. Capabilities: tool status, progress indicators, approval flows, results display. Use for: showing agent tool calls, human-in-the-loop approvals, tool output. Triggers: tool ui, tool calls, tool status, tool approval, tool results, agent tools, mcp tools ui, function calling ui, tool lifecycle, tool pending

JantonioFC/skillsbank

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

JantonioFC/skillsbank

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,'...

JantonioFC/skillsbank

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, expla...

JantonioFC/skillsbank

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awarene...

JantonioFC/skillsbank

Generate AI videos with Google Veo, Seedance, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 1.5 Pro, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, lipsync, avatar animation, video upscaling, fole...

JantonioFC/skillsbank

Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.

JantonioFC/skillsbank

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

Skills relacionados