firefrost-gaming/antigravity-skills-reference

Files

sck_0 6036047c66 chore: repo coherence audit — counts, validation, references, docs

- Align package.json description to 883+ skills
- Allow risk:unknown in validate_skills.py for legacy skills
- Add When to Use section to 6 skills; fix frontmatter in brainstorming, agents-v2-py, hosted-agents-v2-py
- Add scripts/validate_references.py for workflows, bundles, BUNDLES.md links
- Update QUALITY_BAR and SKILL_ANATOMY; add docs/AUDIT.md and MAINTENANCE note for data/
- Make YAML frontmatter test warn instead of fail; regenerate catalog and index

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-02-20 22:00:10 +01:00

2.4 KiB

Raw Blame History

🏆 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, unknown]. Use unknown only for legacy or unclassified skills; prefer a concrete level for new skills.
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:

Level	Badge	Meaning
Official	🟣	Maintained by the core team. High reliability.
Community	⚪	Contributed by the ecosystem. Best effort support.
Verified	✨	Community skill that has passed deep manual review.

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)

2.4 KiB Raw Blame History