From e2879ab560cbfe62c563684cdd355fbc0f4d15ab Mon Sep 17 00:00:00 2001
From: Suhaib Janjua <suhaib.janjua@gmail.com>
Date: Wed, 18 Mar 2026 16:32:03 +0500
Subject: [PATCH] =?UTF-8?q?docs:=20fix=20missing=20required=20frontmatter?=
 =?UTF-8?q?=20fields=20in=20skill-anatomy=20and=20ad=E2=80=A6=20(#333)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs: fix missing required frontmatter fields in skill-anatomy and add missing tools to FAQ

* ci: retrigger checks after PR body update
---
 docs/contributors/skill-anatomy.md | 27 ++++++++++++++++++++++++---
 docs/users/faq.md                  |  3 +++
 2 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/docs/contributors/skill-anatomy.md b/docs/contributors/skill-anatomy.md
index 5d0ca23c..b6474ec8 100644
--- a/docs/contributors/skill-anatomy.md
+++ b/docs/contributors/skill-anatomy.md
@@ -45,6 +45,8 @@ The frontmatter is at the very top, wrapped in `---`:
 ---
 name: my-skill-name
 description: "Brief description of what this skill does"
+risk: safe
+source: community
 ---
 ```
 
@@ -59,9 +61,26 @@ description: "Brief description of what this skill does"
 #### `description`
 - **What it is:** One-sentence summary
 - **Format:** String in quotes
-- **Length:** Keep it under 150 characters
+- **Length:** Keep it under 200 characters
 - **Example:** `"Stripe payment integration patterns including checkout, subscriptions, and webhooks"`
 
+#### `risk`
+- **What it is:** The safety classification of the skill
+- **Values:** `none` | `safe` | `critical` | `offensive` | `unknown`
+- **Example:** `risk: safe`
+- **Guide:**
+  - `none` — pure text/reasoning, no commands or mutations
+  - `safe` — reads files, runs non-destructive commands
+  - `critical` — modifies state, deletes files, pushes to production
+  - `offensive` — pentesting/red-team tools; **must** include "Authorized Use Only" warning
+  - `unknown` — legacy or unclassified; prefer a concrete level for new skills
+
+#### `source`
+- **What it is:** Attribution for the skill's origin
+- **Format:** URL or a short label
+- **Examples:** `source: community`, `source: "https://example.com/original"`
+- **Use `"self"`** if you are the original author
+
 ### Optional Fields
 
 Some skills include additional metadata:
@@ -70,9 +89,11 @@ Some skills include additional metadata:
 ---
 name: my-skill-name
 description: "Brief description"
-version: "1.0.0"
-author: "Your Name"
+risk: safe
+source: community
+author: "your-name-or-handle"
 tags: ["react", "typescript", "testing"]
+tools: [claude, cursor, gemini]
 ---
 ```
 
diff --git a/docs/users/faq.md b/docs/users/faq.md
index 96c5071a..1f0e54f9 100644
--- a/docs/users/faq.md
+++ b/docs/users/faq.md
@@ -37,6 +37,9 @@ Start from:
 - ✅ **Cursor** (AI IDE)
 - ✅ **Antigravity IDE**
 - ✅ **OpenCode**
+- ✅ **Kiro CLI** (Amazon)
+- ✅ **Kiro IDE** (Amazon)
+- ✅ **AdaL CLI**
 - ⚠️ **GitHub Copilot** (partial support via copy-paste)
 
 ### Are these skills free to use?