From bec308fd063d4fba009dbb0c13c5adc378508303 Mon Sep 17 00:00:00 2001 From: lyn Date: Fri, 17 Apr 2026 14:14:43 +0000 Subject: [PATCH] add YAML frontmatter requirement to SKILL.md and guide.md --- claw-skills/SKILL.md | 5 +++++ claw-skills/docs/guide.md | 11 ++++++++++- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/claw-skills/SKILL.md b/claw-skills/SKILL.md index f82c6f8..e95772e 100644 --- a/claw-skills/SKILL.md +++ b/claw-skills/SKILL.md @@ -1,3 +1,8 @@ +--- +name: claw-skills +description: ClawSkills management and collaboration suite — scripts and workflows for using and improving skills. +--- + # claw-skills ClawSkills management and collaboration suite — scripts and workflows for using and improving skills. diff --git a/claw-skills/docs/guide.md b/claw-skills/docs/guide.md index 3d5f32b..3f7ee96 100644 --- a/claw-skills/docs/guide.md +++ b/claw-skills/docs/guide.md @@ -13,7 +13,16 @@ A skill is a directory with the following layout: ## Writing Requirements -**SKILL.md should be concise.** It serves as a table of contents for workflows — list each workflow file path with the scenario that triggers it. +**SKILL.md must start with a YAML frontmatter block:** + +```yaml +--- +name: {skill-name} +description: {when-to-use} +--- +``` + +**SKILL.md body should be concise.** It serves as a table of contents for workflows — list each workflow file path with the scenario that triggers it. For supplementary documentation, use `docs/`. > **All skill-related documentation must be written in English.**