convez.ai
Skill
MONDII-TEK

Claude-Skills

MONDII-TEK/Claude-Skills

Ver no GitHub
InicialPluginScore · de 0 a 100

Skills para Claude Code

Instalação

$npx convez-ai MONDII-TEK/Claude-Skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
25%
Último commit
há 2 dias
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Claude-Skills

Catálogo de skills Claude Code mantenido por MONDII-TEK. Cada subdirectorio es una skill independiente, instalable en cualquier proyecto consumidor.

Skills disponibles

SkillDescripciónStack objetivo
testing-orchestration/Orquesta ciclo de testing Python/Flask + Docker, guardian de plan→test→fix→regression para features y fixes. Cubre unit/API/bg/Stripe, reset+rebuild de stacks, test→fix→re-run loop, manual test orchestration, migration ID validation, i18n coherence checking.Python/Flask + Docker

Fuente original: IronVolt — proyecto de referencia donde nació la skill. La skill está diseñada agnóstica al proyecto: las variables de adopción ({{backend_path}}, {{frontend_path}}, etc.) se resuelven al instalar leyendo el CLAUDE.md del proyecto destino.


testing-orchestration — referencia rápida

Comandos de activación (slash explícitos)

Determinista — el usuario teclea el slash:

ComandoWorkflowArgsPara qué sirve
/testing-orchestration—sin argsCarga la skill manualmente
/testing-orchestration design <título>G plan-guardiantítulo freeformDiseñar plan de test antes de empezar feature/fix (Service→Unit→Route→Integration→Build+RUN→Frontend→i18n→Manual→Docs)
/testing-orchestration run <test:cmd>C run + auditcomando manage.sh con flagsEjecutar test:unit / test:module / test:api / test:bg / test:stripe / test:full y auditar el run dir generado
/testing-orchestration restart-devA restart devsin argsdown → build prod/dev/test → up:dev (ciclo de rebuild completo)
/testing-orchestration restart-testB restart testsin argsBajar test stack zombi y rebuild de la imagen test (pre-req limpio para test:*)
/testing-orchestration affectedE detect afectadossin args (lee git diff)Identificar qué tests cubren el cambio actual y proponer test:module mínimo
/testing-orchestration manual <feature>F manual UInombre del flujoOrquestar test manual desde la perspectiva del usuario en navegador
/testing-orchestration audit <run-dir>Audit standalonepath al run dirAuditar logs/test_runs/<ts>_<label>/ post-run (summary, errors, flaky markers)
/testing-orchestration validate-migrationsH validate migrationssin argsValidar Alembic (IDs duplicados, branches no intencionados, orphan down_revision)
/testing-orchestration statusI sprint statussin argsReporte ejecutivo: últimos runs, bugs activos/cerrados, markers vivos, drift scripts↔skill
/testing-orchestration self-checkK self-checksin argsVerificar adopción de la skill al proyecto destino (CLAUDE.md, docker stack, env vars)

Auto-trigger (modelo decide — sin teclear)

Frases típicas que activan la skill por description match:

Trigger phraseWorkflow probable
"voy a añadir feature" / "diseñar plan"G — plan-guardian
"test:module …" / "test:stripe …" / "test:full" / "test:bg" / "test:unit"C — run + audit
"down y rebuild" / "rebuild test image"A o B (restart)
"qué tests cubren …" / "regression check"E — detect afectados
"manual test from user perspective"F — manual UI
"fix and re-run"D — test → fix → re-run loop
"valida migraciones"H — validate migrations
"report status"I — sprint status
"actualiza i18n" / "i18n missing locale" / "añade traducción"J — i18n coherence
manage.sh / mt.sh mencionadoC / D según contexto

Workflows (resumen)

LetraNombreCuándo se activaResultado
GPlan-guardianAntes de empezar feature/fixPlantilla de plan + checklist de capas a cubrir
ARestart dev"down y rebuild de todo"Stack dev limpio en up:dev
BRestart test stackAntes de un test:* con zombi suspectTest stack limpio, imagen test fresh
CRun + auditCualquier test:* invocadoEjecuta + audita run dir + reporta markers
DTest → fix → re-runTest rojo + fix aplicadoLoop sequencial hasta verde sin regresiones
EDetect afectadosHay cambios staged/unstagedLista mínima de test:* que cubre el cambio
FManual UI testFeature user-facing nuevaChecklist navegador + golden path + edge cases
HValidate migrationsAntes de commit con nueva migraciónPasa/falla con dups, branches, orphans
ISprint statusReporte periódicoSnapshot ejecutivo de runs/bugs/markers
Ji18n coherenceCambio de strings UIVerifica 4 locales sincronizados (es/en/fr/it)
KSelf-check adopciónTras instalar skill en otro repoReporta gaps de adopción (CLAUDE.md, env, paths)

Scripts incluidos (testing-orchestration/scripts/)

ScriptLenguajePara qué sirve
manage.shbashCopia de referencia del orquestador del proyecto fuente. Se usa como espejo para detectar drift contra <proyecto>/scripts/manage.sh (ver sync-skill-scripts.sh). No se ejecuta directamente por la skill.
mt.shbashCopia de referencia del helper mt.sh (manual test middleware con env: BASE_URL, ADMIN_TOKEN, STRIPE_KEY, restore membership, reset credits, force token refresh). Mismo rol: detectar drift.
stripe_heavy_collect.pypythonColecciona class-level nodeids para pytest 9+ (que cambió formato --collect-only -q de flat a tree). Lo usa el corredor de stripe_heavy para invocar pytest con isolación class-by-class.
sync-skill-scripts.shbashPre-commit hook que falla el commit si scripts/<X> cambió pero skills/testing-orchestration/scripts/<X> no. Previene drift entre orquestador del repo y la copia de la skill. Adaptable vía WATCHED_SCRIPTS env var.
validate_migrations.shbashValidador de Alembic: detecta IDs de revisión duplicados, branches no intencionados (multiple migraciones con mismo parent), y orphan down_revision references. Parametrizable vía MIGRATIONS_DIR. Invocado por workflow H.

Documentación detallada (dentro de la skill)

ArchivoContenido
SKILL.mdEntry point + adopción al proyecto + invariants + triggers
workflows.mdDetalle paso a paso de cada workflow A-K
commands-reference.mdReferencia exhaustiva de slash commands + ejemplos
policies.mdMarkers (xfail/xpass/stripe_heavy/bg_heavy), políticas de retry, exclusión
stripe-integration.mdPatrones específicos para tests Stripe (sidecar, test_clocks, webhooks)
manual-testing.mdGuía operativa de tests manuales (workflow F)
plan-template.mdPlantilla de plan-guardian (workflow G)
bug-tracker-template.mdEsquema de 051_bug_tracker.md (activo) + _history.md (cerrado)
audit.mdPatrón de auditoría post-run (workflow C/D/F)

Instalación en un proyecto consumidor

Hay tres rutas. Elige según cómo quieras gestionar la dependencia:

Opción A — Submodule (recomendada)

Pin del SHA exacto en el repo consumidor. Cambios en la skill no afectan al consumidor hasta que éste haga bump explícito. Útil cuando la skill evoluciona y quieres versionado controlado.

# Una sola vez, en el proyecto consumidor:
git submodule add https://github.com/MONDII-TEK/Claude-Skills.git skills
git commit -m "chore: add Claude-Skills submodule"

# Para que Claude Code la descubra (auto-discovery):
# El proyecto debe tener (o añadir) un comando que copie skills/<name>/
# a .claude/skills/<name>/. En IronVolt eso es:
./scripts/manage.sh install:skill testing-orchestration

Por qué copia y no symlink: algunos runtimes que indexan .claude/skills/ con find -L o realpath no resuelven symlinks de forma fiable durante cold-start. La copia es portable, runtime-friendly y permite distribuir .claude/skills/ standalone.

Clones nuevos del repo consumidor

git clone --recursive <consumer-repo-url>
# o si ya clonaste sin --recursive:
git submodule update --init --recursive

Adoptar una nueva versión publicada en main

git submodule update --remote skills
git add skills
git commit -m "chore(skill): bump testing-orchestration to <new-SHA>"
./scripts/manage.sh install:skill testing-orchestration --force

Opción B — Clone standalone fuera del proyecto

Si no quieres acoplar git a la skill o usas la skill en múltiples proyectos sin versionarla por proyecto:

# Clona en cualquier lugar, p.ej. ~/skills-cache/
git clone https://github.com/MONDII-TEK/Claude-Skills.git ~/skills-cache/claude-skills

# Copia la skill al proyecto destino:
cp -R ~/skills-cache/claude-skills/testing-orchestration/ \
      <project-root>/.claude/skills/testing-orchestration/

Pros: cero acoplamiento. Contras: sincronización manual; nadie te avisa si la upstream cambia.

Opción C — Copia directa (one-shot)

Para experimentar o llevarte la skill a un proyecto que nunca volverá a actualizarse:

# Descarga el tarball del repo y extrae solo la skill:
curl -sSL https://github.com/MONDII-TEK/Claude-Skills/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=1 -C <project-root>/.claude/skills/ \
        Claude-Skills-main/testing-orchestration

Sin git, sin historia, sin updates. La opción más rápida pero la menos mantenible.

Convenciones

  • Cada skill = un subdirectorio con SKILL.md en su raíz (formato Claude Code: frontmatter name + description).
  • Documentación cruzada dentro de la skill: workflows.md, commands-reference.md, policies.md, manual-testing.md, etc.
  • Scripts que la skill provee viven en <skill>/scripts/ y son sincronizables al proyecto consumidor según las instrucciones de cada skill.
  • Nombres de skill: lowercase + hyphens, deben empezar por letra. Validado por cmd_install_skill en proyectos consumidores que reusen el patrón de IronVolt.

Workflow para colaborar en la skill desde un consumidor

Cuando trabajas en un proyecto que tiene Claude-Skills como submodule y quieres editar la skill:

cd skills                              # entras al submodule
git checkout main                      # asegúrate de estar en main
# ...edita SKILL.md, workflows.md, etc.
git add .
git commit -m "feat(skill): X"
git push origin main                   # publica en Claude-Skills
cd ..
git add skills                         # actualiza el pin en el consumidor
git commit -m "chore(skill): bump to <new-SHA>"
./scripts/manage.sh install:skill <skill-name> --force   # refresca .claude/skills/

Estado y compatibilidad

  • Repo público y reutilizable: el contenido es agnóstico. Resolver placeholders de adopción ({{backend_path}}, etc.) leyendo CLAUDE.md del proyecto destino — ver testing-orchestration/SKILL.md §"Adopción al proyecto" para el listado completo de variables.
  • Sin breaking changes en main sin tag: cuando una skill cambie de forma incompatible, se etiquetará con vX.Y.Z. Consumidores con submodule pueden pinear a un tag (git submodule update --remote --depth 1 + checkout del tag dentro del submodule).

Licencia

Ver LICENSE (a definir — heredada de IronVolt si aplica).


Mantenido por MONDII-TEK.

Ver o original no GitHub

Bom para

Relacionados