# Ecosystem Watcher

> Skill: Ecosystem Watcher

- Skill: `gonzalezpazmonica/ecosystem-watcher` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add gonzalezpazmonica/ecosystem-watcher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gonzalezpazmonica/ecosystem-watcher/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gonzalezpazmonica (https://skillmd.com/u/gonzalezpazmonica)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gonzalezpazmonica/ecosystem-watcher

---


# Skill: Ecosystem Watcher

> Vigilancia continua del ecosistema. Sin esto, cada vez que Savia necesita "estado del arte" alguien tiene que rehacer la investigación desde cero. SPEC-146.

## When to use

- Cron mensual (1º de mes 09:00 UTC) vía GitHub Action.
- Manual: cuando se quiere ver qué ha cambiado desde el último snapshot.
- Tras releases mayores del ecosistema (Claude Code update, OpenCode major).

## Inputs

- Watch list: `docs/rules/domain/ecosystem-watch-list.yaml`.
- Último snapshot timestamp: leído de `.savia-memory/ecosystem-snapshots/last-run.txt`.

## Workflow

1. **Cargar watch list** YAML con repos + docs.
2. **Para cada repo GitHub**:
   - `gh api repos/{owner}/{name}/commits?since={last_run}` → contar commits.
   - `gh api repos/{owner}/{name}/releases` → listar releases nuevos.
   - Guardar snapshot en `.savia-memory/ecosystem-snapshots/{slug}-{YYYY-MM}.md`.
3. **Para cada docs URL**:
   - `WebFetch` la URL.
   - Diff contra snapshot anterior si existe.
4. **Clasificar señales**:
   - **High**: cambios que tocan algún spec PROPOSED (cross-ref con `docs/propuestas/`).
   - **Medium**: relevantes sin acción inmediata.
   - **Low**: ruido informativo.
5. **Generar informe** `output/research-skills-update-{YYYY-MM}.md`.
6. **Anotar** una línea en `output/ecosystem-watcher-history.jsonl`.

## Fail-safe

- Repo inaccesible → log warning + skip, no abortar.
- Rate-limit GitHub → retry con backoff exponencial, máx 3 intentos.
- Snapshot corrupto → regenerar desde cero, marcar en informe.

## Output schema

```markdown
# Ecosystem watch — YYYY-MM

## High signal (acción recomendada)
- [repo/source]: descripción + ref a SPEC afectado

## Medium signal (informativo)
- ...

## Low signal (ruido)
- ...

## Stats
- repos checked: N
- repos failed: N
- docs checked: N
```

## Anti-patterns

- **NO** abrir PRs automáticos basados en hallazgos.
- **NO** modificar specs PROPOSED — solo cross-reference.
- **NO** consumir tokens de Claude para clasificación si un regex/grep funciona.

## Acceptance Criteria

Ver `docs/propuestas/SPEC-146-awesome-repos-monthly-watcher.md`.

