docs: fix missing required frontmatter fields in skill-anatomy and ad… (#333)

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

* ci: retrigger checks after PR body update
This commit is contained in:
Suhaib Janjua
2026-03-18 16:32:03 +05:00
committed by GitHub
parent 33cd7bbda5
commit e2879ab560
2 changed files with 27 additions and 3 deletions

View File

@@ -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]
---
```

View File

@@ -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?