yfm — skill0
Adopter le YFM
Utilisez YFM pour tout markdown qu'un agent, un index, ou un pipeline d'ontologie peut scanner. Suivez le dialecte existant si l'un est déjà en usage (Agent Skills, Obsidian, Jekyll, Hugo, etc.) — le défaut x-cmd s'applique uniquement quand aucun autre dialecte ne régit.
Le défaut x-cmd : trois champs
---
tags: [design, front-matter]
description: Résumé en une phrase qu'un lecteur utilise pour décider d'ouvrir ce fichier.
memo:
2026-07-31T14:30:00+08:00: Coupe les alias ; renommé le troisième champ en memo.
---
# Titre
Corps...
tags— liste top-level de slugs[a-z0-9-]. Consommateur : le collecteur pour l'indexation ontologique.description— chaîne top-level. Une phrase. Pas ledescription:d'Agent Skills (qui est un requirement SKILL.md-only, régi parskill0-writer).memo:— map top-level, le journal de révision du fichier. Les clés sont des timestamps ISO 8601 (YYYY-MM-DDTHH:mm:ss±HH:mm, offset local de l'auteur) ; les valeurs sont de courtes descriptions de changement. Le plus récent d'abord. Omettez quand aucune histoire ne mérite d'être consignée.
Périmètre d'application
<project>/.x-cmd/story/— étend avecissue:— voir usecase/story.md.- Corps d'issue / PR GitHub — étend avec
repo:,number:— voir usecase/git-issue-pr-wiki-markdown-etc.md. - GitHub
README.md— champs par défaut uniquement.
Module
Le module yfm est un helper. Trois commandes :
x yfm ls [path]— liste les blocs YFM ; par défaut le répertoire courantx yfm init [path]— écrit un bloc x-cmd-default dans chaque fichier markdown sous le pathx yfm lint [path]— vérifie que chaque bloc YFM est du YAML valide et suit le dialecte qu'il prétend suivre
Lire du front matter étranger
Le collecteur ingère de nombreux dialectes. Pour la spec dont le défaut est emprunté, voir https://agentskills.io/specification. Par dialecte :
- Agent Skills —
metadata:est string→string ; le top-level est fermé - Obsidian —
tags/aliases/cssclassesréservés - Jekyll — liste ou séparés par espace
- Hugo — TOML possible ; taxonomie configurée par le site