Quality Bar & Validation Standards

🏆 Quality Bar & Validation Standards

To transform Antigravity Awesome Skills from a collection of scripts into a trusted platform, every skill must meet a specific standard of quality and safety.

The "Validated" Badge ✅

A skill earns the "Validated" badge only if it passes these 5 automated checks:

1. Metadata Integrity

The SKILL.md frontmatter must be valid YAML and contain:

• name: Kebab-case, matches folder name.
• description: Under 200 chars, clear value prop.
• risk: One of [none, safe, critical, offensive].
• source: URL to original source (or "self" if original).

2. Clear Triggers ("When to use")

The skill MUST have a section explicitly stating when to trigger it.

• Good: "Use when the user asks to debug a React component."
• Bad: "This skill helps you with code." Accepted headings: ## When to Use, ## Use this skill when, ## When to Use This Skill.

3. Safety & Risk Classification

Every skill must declare its risk level:

• 🟢 none: Pure text/reasoning (e.g., Brainstorming).
• 🔵 safe: Reads files, runs safe commands (e.g., Linter).
• 🟠 critical: Modifies state, deletes files, pushes to prod (e.g., Git Push).
• 🔴 offensive: Pentesting/Red Team tools. MUST have "Authorized Use Only" warning.

4. Copy-Pasteable Examples

At least one code block or interaction example that a user (or agent) can immediately use.

5. Explicit Limitations

A list of known edge cases or things the skill cannot do.

• Example: "Does not work on Windows without WSL."

Support Levels

We also categorize skills by who maintains them:

How to Validate Your Skill

The canonical validator is scripts/validate_skills.py. Run npm run validate (or npm run validate:strict) before submitting a PR:

npm run validate       # soft mode (warnings only)
npm run validate:strict  # strict mode (CI uses this)