165 lines
7.4 KiB
Markdown
165 lines
7.4 KiB
Markdown
---
|
||
description: Mettre à jour le tableau SKILL COLLECTIONS en recherchant les 5 dépôts de collections de skills en parallèle
|
||
---
|
||
|
||
# Workflow — Skill Collections
|
||
|
||
Mets à jour le tableau SKILL COLLECTIONS dans `README.md` en recherchant 5 dépôts en parallèle. Lance un agent de recherche, fusionne les résultats, présente les changements et mets le tableau à jour si approuvé.
|
||
|
||
---
|
||
|
||
## Les 5 dépôts
|
||
|
||
| # | Repo | Owner |
|
||
|---|------|-------|
|
||
| 1 | `anthropics/skills` | Anthropic (official) |
|
||
| 2 | `wshobson/agents` | William Shobson |
|
||
| 3 | `mattpocock/skills` | Matt Pocock |
|
||
| 4 | `K-Dense-AI/scientific-agent-skills` | K-Dense-AI |
|
||
| 5 | `VoltAgent/awesome-agent-skills` | VoltAgent (curated awesome-list) |
|
||
|
||
---
|
||
|
||
## Format du tableau
|
||
|
||
Le tableau README a ces colonnes :
|
||
|
||
```markdown
|
||
| Name | ★ | <img src="!/tags/s.svg" height="14"> |
|
||
```
|
||
|
||
- **Name** : `[Short Name](github-url)` — utilise le nom court du dépôt (par exemple `mattpocock/skills`, ou seulement `skills` si le propriétaire est le projet), pas le `owner/repo` complet sauf ambiguïté
|
||
- **★** : nombre d’étoiles arrondi en `k` (par exemple 125k, 35k, 1.2k). Sous 1000, afficher le nombre exact
|
||
- **Nombre de skills** : seulement le nombre. Pour les awesome-lists où les skills sont des *liens* et non des fichiers, utilise la forme `N+ (curated list)`
|
||
|
||
**Ordre de tri** : trié par étoiles décroissantes (le plus élevé d’abord).
|
||
|
||
---
|
||
|
||
## Phase 0 : lire l’état actuel
|
||
|
||
Lis ces fichiers :
|
||
|
||
1. `README.md` — le tableau `## 🧰 SKILL COLLECTIONS` (noter les étoiles et nombres de skills actuels)
|
||
2. `changelog/skill-collections/changelog.md` — entrées de changelog précédentes (peut ne pas encore exister)
|
||
|
||
---
|
||
|
||
## Phase 1 : lancer l’agent de recherche
|
||
|
||
**Immédiatement**, lance un `development-workflows-research-agent` couvrant les 5 dépôts. (L’agent de recherche existant est générique — il compte skills/étoiles/etc. pour n’importe quel dépôt.)
|
||
|
||
> Research these 5 Claude Code **skill-collection** repositories. Each is primarily a library of `SKILL.md` files, NOT a full workflow methodology.
|
||
>
|
||
> **Repo 1: anthropics/skills** (https://github.com/anthropics/skills) — official Anthropic skills repo
|
||
> **Repo 2: wshobson/agents** (https://github.com/wshobson/agents) — plugin-scoped skills (skills nested under domain plugins)
|
||
> **Repo 3: mattpocock/skills** (https://github.com/mattpocock/skills) — TypeScript-focused
|
||
> **Repo 4: K-Dense-AI/scientific-agent-skills** (https://github.com/K-Dense-AI/scientific-agent-skills) — science/research vertical
|
||
> **Repo 5: VoltAgent/awesome-agent-skills** (https://github.com/VoltAgent/awesome-agent-skills) — curated awesome-list (links to external skills, not SKILL.md files in repo)
|
||
>
|
||
> For EACH repo, return:
|
||
>
|
||
> 1. **Stars** — use GitHub API `https://api.github.com/repos/{owner}/{repo}`, read `stargazers_count`. Round to `k`.
|
||
> 2. **Skill count** — count `SKILL.md` files in the repo via the GitHub git tree API:
|
||
> `https://api.github.com/repos/{owner}/{repo}/git/trees/HEAD?recursive=1` and grep paths for `SKILL.md`.
|
||
> - For `wshobson/agents`: skills are nested inside `plugins/<domain>/skills/` — count all SKILL.md across all plugins.
|
||
> - For `VoltAgent/awesome-agent-skills`: count the *listed* skills in README.md (e.g., bullets / table rows). Mark explicitly as "curated list, not files".
|
||
> - For `K-Dense-AI/scientific-agent-skills`: subdirectories under `skills/` may use SKILL.md or `.md`; count whichever the repo uses, and report which.
|
||
> - For `anthropics/skills`: skills live in subdirectories under `skills/` with `SKILL.md` inside.
|
||
> - For `mattpocock/skills`: include only **active** skills, not deprecated ones (note both numbers if obvious).
|
||
> 3. **Notable changes** — any significant additions or removals in last 30 days?
|
||
>
|
||
> Return structured report per repo:
|
||
> ```
|
||
> REPO: anthropics/skills
|
||
> STARS: <number>k (<exact>)
|
||
> SKILLS: <count> (<file pattern used, e.g., "SKILL.md files via git tree">)
|
||
> NOTES: <anything unusual — flat .md vs SKILL.md, deprecated skills, language variants, curated-list disclaimer>
|
||
> CHANGES: <changes or "No significant changes">
|
||
> CONFIDENCE: <0-1>
|
||
> ```
|
||
|
||
---
|
||
|
||
## Phase 2 : comparer et rapporter
|
||
|
||
**Attends l’agent.** Compare ensuite les constats avec le tableau actuel et présente :
|
||
|
||
```text
|
||
Skill Collections — Update Report
|
||
══════════════════════════════════
|
||
|
||
Changes Found:
|
||
<repo>: ★ <old>k → <new>k | skills <old>→<new>
|
||
...
|
||
|
||
No Changes:
|
||
<repo>: ✓ (all values match)
|
||
...
|
||
|
||
Action Items:
|
||
# | Type | Action | Status
|
||
1 | Star | Update <repo> ★ from Xk to Yk | NEW/RECURRING
|
||
2 | Count | Update <repo> skills from X to Y | NEW/RECURRING
|
||
3 | Sort | Move <repo> (rank changed) | NEW/RECURRING
|
||
4 | Add | New collection candidate: <repo> | NEW
|
||
```
|
||
|
||
Compare avec les entrées précédentes du changelog et marque les éléments `NEW`, `RECURRING` ou `RESOLVED`.
|
||
|
||
---
|
||
|
||
## Phase 2.5 : ajouter au changelog
|
||
|
||
**OBLIGATOIRE** — toujours exécuter avant de présenter à l’utilisateur.
|
||
|
||
Lis `changelog/skill-collections/changelog.md`, puis **ajoute** une nouvelle entrée. Si le fichier n’existe pas, crée-le avec une Status Legend puis la première entrée.
|
||
|
||
```markdown
|
||
---
|
||
|
||
## [<YYYY-MM-DD HH:MM AM/PM PKT>] Skill Collections Update
|
||
|
||
| # | Priority | Type | Action | Status |
|
||
|---|----------|------|--------|--------|
|
||
| 1 | HIGH/MED/LOW | <type> | <action> | <status> |
|
||
```
|
||
|
||
Obtiens l’heure via `TZ=Asia/Karachi date "+%Y-%m-%d %I:%M %p PKT"`. Le statut doit être l’un de :
|
||
- `COMPLETE (reason)` | `INVALID (reason)` | `ON HOLD (reason)`
|
||
|
||
Toujours ajouter, ne jamais écraser.
|
||
|
||
---
|
||
|
||
## Phase 2.6 : mettre à jour le badge Last Updated
|
||
|
||
**OBLIGATOIRE** — exécuter après la Phase 2.5.
|
||
|
||
Mets à jour le badge de la ligne 4 de `README.md`. Obtiens l’heure via `TZ=Asia/Karachi date "+%b %d, %Y %-I:%M %p PKT"`, encode-la pour URL et remplace la date dans le badge. Ne journalise PAS cela comme action item.
|
||
|
||
---
|
||
|
||
## Phase 3 : exécuter
|
||
|
||
Demande à l’utilisateur : **(1) Execute all** | **(2) Execute specific** | **(3) Skip**
|
||
|
||
Pendant l’exécution, modifie le tableau `## 🧰 SKILL COLLECTIONS` dans `README.md` :
|
||
- Mettre à jour les étoiles et nombres de skills par ligne
|
||
- Maintenir l’ordre de tri : étoiles décroissantes (le plus élevé d’abord)
|
||
- Respecter exactement le format existant (style des liens, suffixe k sur les étoiles)
|
||
|
||
---
|
||
|
||
## Règles
|
||
|
||
1. **Un agent de recherche, 5 dépôts** — message unique, sous-récupérations parallèles à l’intérieur
|
||
2. **Ne jamais deviner** — utiliser uniquement les données de l’agent
|
||
3. **Ne pas auto-exécuter** — présenter le rapport d’abord, attendre approbation
|
||
4. **TOUJOURS ajouter au changelog** et **TOUJOURS mettre à jour le badge** — obligatoire
|
||
5. **Trier par étoiles décroissantes** — plus grand nombre d’étoiles d’abord
|
||
6. **Arrondir les étoiles de façon cohérente** — suffixe `k` (125k, 35k, 1.2k). Sous 1000, afficher le nombre exact
|
||
7. **Les awesome-lists sont différentes** — pour les dépôts qui lient vers des skills externes (VoltAgent), le nombre est "items listed in README", pas les fichiers du dépôt ; toujours annoter `(curated list)`
|
||
8. **Comparer avec le changelog précédent** — marquer les éléments NEW, RECURRING ou RESOLVED
|
||
9. **Réutiliser `development-workflows-research-agent`** — ne PAS créer de nouvel agent
|