write-a-skill — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited write-a-skill (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
skill-name/
├── SKILL.md # Main instructions (required)
├── REFERENCE.md # Detailed docs (if needed)
├── EXAMPLES.md # Usage examples (if needed)
└── scripts/ # Utility scripts (if needed)
└── helper.js---
name: skill-name
description: Brief description of capability. Use when [specific triggers].
---
# Skill Name
## Quick start
[Minimal working example]
## Workflows
[Step-by-step processes with checklists for complex tasks]
## Advanced features
[Link to separate files: See [REFERENCE.md](REFERENCE.md)]description 是 agent 决定加载哪个 skill 时唯一能看到的内容。它会和所有其他已安装 skills 一起出现在 system prompt 中。你的 agent 会读取这些 descriptions，并根据用户请求选择相关 skill。
Goal：给 agent 足够的信息，让它知道：
Format：
Good example：
Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.Bad example：
Helps with documents.坏示例无法让 agent 把它和其他 document skills 区分开。
在以下情况添加 utility scripts：
相比 generated code，Scripts 能节省 tokens 并提升可靠性。
在以下情况拆分为单独文件：
Draft 完成后验证：
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.