Ingest

Ingest - capturer et classer un contenu

Prendre un contenu brut (URL, texte collé, transcript, article) et l'intégrer au bon endroit de ton vault, avec le bon format, les bons liens et une synthèse courte. C'est l'acte de base d'un second cerveau : capturer sans créer de désordre.

Trigger : /ingest . Le contenu est dans les arguments.

Principe

Le skill ne plaque pas une arborescence toute faite : il apprend ta taxonomie en lisant la documentation de ton vault, puis classe le contenu dans tes catégories. Si ton vault ne déclare rien, il retombe sur une taxonomie générique raisonnable.

Étape 1 : Apprendre la structure du vault

Lire la doc que le vault donne sur lui-même : fichiers d'instructions (CLAUDE.md, AGENTS.md...), index (README.md, INDEX.md, MOC), et toute règle de rangement ou de nommage. But : connaître les dossiers existants, leur rôle, et les conventions (nommage, frontmatter, format de date) avant de décider où ranger.

Taxonomie de repli (si le vault ne déclare rien d'exploitable) :

| Catégorie | Destination type | Quand | |---|---|---| | Ressource externe | veille/AAAA-MM-JJ-slug.md | Article, vidéo, podcast, post externe | | Transcript de réunion | meetings/AAAA-MM-JJ-slug.md | Call, réunion, interview | | Leçon / pattern | notes/slug.md | Insight réutilisable, erreur documentée | | Réflexion / décision | dossier projet concerné | Décision structurante, pivot | | Méthode / SOP | processes/slug.md | Procédure reproductible |

Étape 2 : Identifier le type de contenu

• URL -> récupérer le contenu (WebFetch ; pour une vidéo, en récupérer le transcript si possible).
• Texte collé -> analyser directement.
• Référence à un fichier local -> le lire.

Si le contenu est vide ou ambigu, demander de préciser.

Étape 3 : Classer

Déterminer la catégorie (taxonomie du vault, sinon repli) à partir de : type de source (externe / transcript / libre), sujet, intention probable (apprendre / documenter / décider / archiver). Si rien ne matche clairement, demander plutôt que deviner.

Si ton vault a un skill dédié pour un type précis (réunions, vidéos...), défère-lui plutôt que de le traiter ici.

Étape 4 : Extraire et synthétiser

Synthèse adaptée à la catégorie, courte :

• Ressource externe : titre, source, date, 3-5 puces d'insights clés.
• Transcript : participants, décisions, actions, points ouverts.
• Leçon / pattern : le pattern en une phrase, le contexte d'où il vient, comment l'appliquer.
• Réflexion / décision : la thèse, les arguments pour/contre, la décision ou la question ouverte.

Étape 5 : Proposer avant d'écrire

Afficher : catégorie choisie, destination (chemin), synthèse générée. Attendre la validation avant d'écrire quoi que ce soit.

Étape 6 : Écrire et relier

Après validation :

1. Créer le fichier au bon endroit, format type :

```markdown # {Titre}

{Synthèse structurée selon la catégorie}

## Source

• {URL ou référence}
• Date d'ingestion : {AAAA-MM-JJ}

## Liens

• [[lien pertinent 1]]
• [[lien pertinent 2]]

```

1. Relier aux entités mentionnées (projets, personnes, sujets) déjà présentes dans le vault.
2. Si ton vault tient un journal (daily) ou un index, y ajouter une ligne - seulement s'il existe.

Règles

• Ne jamais écrire sans validation.
• Ne pas créer un dossier inexistant sans demander (vérifier l'arborescence avant).
• Anti-doublon : chercher (grep par URL ou titre) si un fichier similaire existe déjà avant de créer.
• Nommage : AAAA-MM-JJ-slug.md (daté) ou slug.md, slug en kebab-case ( note/pattern, réflexion ou process |

| Créer un fichier dans un dossier inexistant | Vérifier avant ; créer le dossier après validation seulement | | Résumé trop long | 3-5 puces pour une ressource, synthèse courte sinon | | Oublier les liens | Toujours relier aux entités mentionnées | | Ré-ingérer un contenu déjà présent | Grep par URL/titre avant de créer |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ColinDargent
• Source: ColinDargent/second-cerveau
• License: MIT

Install and usage instructions live in the source repository linked above.