chore: sync repo state [ci skip]
This commit is contained in:
github-actions[bot]
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "antigravity-awesome-skills",
|
||||
"version": "9.8.0",
|
||||
"description": "Plugin-safe Claude Code distribution of Antigravity Awesome Skills with 1,365 supported skills.",
|
||||
"description": "Plugin-safe Claude Code distribution of Antigravity Awesome Skills with 1,367 supported skills.",
|
||||
"author": {
|
||||
"name": "sickn33 and contributors",
|
||||
"url": "https://github.com/sickn33/antigravity-awesome-skills"
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Generated at: 2026-02-08T00:00:00.000Z
|
||||
|
||||
Total skills: 1379
|
||||
Total skills: 1381
|
||||
|
||||
## architecture (91)
|
||||
|
||||
@@ -181,7 +181,7 @@ Total skills: 1379
|
||||
| `warren-buffett` | Agente que simula Warren Buffett — o maior investidor do seculo XX e XXI, CEO da Berkshire Hathaway, discipulo de Benjamin Graham e socio intelectual de Char... | persona, investing, value-investing, business | persona, investing, value-investing, business, warren, buffett, agente, que, simula, maior, investidor, do |
|
||||
| `whatsapp-automation` | Automate WhatsApp Business tasks via Rube MCP (Composio): send messages, manage templates, upload media, and handle contacts. Always search tools first for c... | whatsapp | whatsapp, automation, automate, business, tasks, via, rube, mcp, composio, send, messages, upload |
|
||||
|
||||
## data-ai (260)
|
||||
## data-ai (262)
|
||||
|
||||
| Skill | Description | Tags | Triggers |
|
||||
| --- | --- | --- | --- |
|
||||
@@ -313,6 +313,8 @@ Total skills: 1379
|
||||
| `drizzle-orm-expert` | Expert in Drizzle ORM for TypeScript — schema design, relational queries, migrations, and serverless database integration. Use when building type-safe databa... | drizzle, orm | drizzle, orm, typescript, schema, relational, queries, migrations, serverless, database, integration, building, type |
|
||||
| `dwarf-expert` | Provides expertise for analyzing DWARF debug files and understanding the DWARF debug format/standard (v3-v5). Triggers when understanding DWARF information, ... | dwarf | dwarf, provides, expertise, analyzing, debug, files, understanding, format, standard, v3, v5, triggers |
|
||||
| `embedding-strategies` | Guide to selecting and optimizing embedding models for vector search applications. | embedding, strategies | embedding, strategies, selecting, optimizing, models, vector, search, applications |
|
||||
| `faf-expert` | Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync. | faf, ai-context, project-management, mcp, iana | faf, ai-context, project-management, mcp, iana, foundational, ai, context, format, registered, server, config |
|
||||
| `faf-wizard` | Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere. | faf, automation, project-setup, ai-context, productivity | faf, automation, project-setup, ai-context, productivity, wizard, done, generator, one, click, ai, context |
|
||||
| `fal-audio` | Text-to-speech and speech-to-text using fal.ai audio models | fal, audio | fal, audio, text, speech, ai, models |
|
||||
| `fal-generate` | Generate images and videos using fal.ai AI models | fal, generate | fal, generate, images, videos, ai, models |
|
||||
| `fal-image-edit` | AI-powered image editing with style transfer and object removal | fal, image, edit | fal, image, edit, ai, powered, editing, style, transfer, object, removal |
|
||||
|
||||
14
README.md
14
README.md
@@ -1,13 +1,13 @@
|
||||
<!-- registry-sync: version=9.8.0; skills=1379; stars=31066; updated_at=2026-04-06T18:46:20+00:00 -->
|
||||
# 🌌 Antigravity Awesome Skills: 1,379+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
|
||||
<!-- registry-sync: version=9.8.0; skills=1381; stars=31066; updated_at=2026-04-06T18:46:20+00:00 -->
|
||||
# 🌌 Antigravity Awesome Skills: 1,381+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
|
||||
|
||||
> **Installable GitHub library of 1,379+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.**
|
||||
> **Installable GitHub library of 1,381+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.**
|
||||
|
||||
Antigravity Awesome Skills is an installable GitHub library and npm installer for reusable `SKILL.md` playbooks. It is designed for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, Kiro, OpenCode, GitHub Copilot, and other AI coding assistants that benefit from structured operating instructions. Instead of collecting one-off prompt snippets, this repository gives you a searchable, installable catalog of skills, bundles, workflows, plugin-safe distributions, and practical docs that help agents perform recurring tasks with better context, stronger constraints, and clearer outputs.
|
||||
|
||||
You can use this repo to install a broad multi-tool skill library, start from role-based bundles, or jump into workflow-driven execution for planning, coding, debugging, testing, security review, infrastructure, product work, and growth tasks. The root README is intentionally a high-signal landing page: understand what the project is, install it quickly, choose the right tool path, and then follow deeper docs only when you need them.
|
||||
|
||||
**Start here:** [Star the repo](https://github.com/sickn33/antigravity-awesome-skills/stargazers) · [Install in 1 minute](#installation) · [Choose your tool](#choose-your-tool) · [Best skills by tool](#best-skills-by-tool) · [📚 Browse 1,379+ Skills](#browse-1379-skills) · [Bundles](docs/users/bundles.md) · [Workflows](docs/users/workflows.md) · [Plugins for Claude Code and Codex](docs/users/plugins.md)
|
||||
**Start here:** [Star the repo](https://github.com/sickn33/antigravity-awesome-skills/stargazers) · [Install in 1 minute](#installation) · [Choose your tool](#choose-your-tool) · [Best skills by tool](#best-skills-by-tool) · [📚 Browse 1,381+ Skills](#browse-1381-skills) · [Bundles](docs/users/bundles.md) · [Workflows](docs/users/workflows.md) · [Plugins for Claude Code and Codex](docs/users/plugins.md)
|
||||
|
||||
[](https://github.com/sickn33/antigravity-awesome-skills/stargazers)
|
||||
[](LICENSE)
|
||||
@@ -28,7 +28,7 @@ You can use this repo to install a broad multi-tool skill library, start from ro
|
||||
|
||||
- **Installable, not just inspirational**: use `npx antigravity-awesome-skills` to put skills where your tool expects them.
|
||||
- **Built for major agent workflows**: Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, Kiro, OpenCode, Copilot, and more.
|
||||
- **Broad coverage with real utility**: 1,379+ skills across development, testing, security, infrastructure, product, and marketing.
|
||||
- **Broad coverage with real utility**: 1,381+ skills across development, testing, security, infrastructure, product, and marketing.
|
||||
- **Faster onboarding**: bundles and workflows reduce the time from "I found this repo" to "I used my first skill".
|
||||
- **Useful whether you want breadth or curation**: browse the full catalog, start with top bundles, or compare alternatives before installing.
|
||||
|
||||
@@ -127,7 +127,7 @@ Start with [Bundles](docs/users/bundles.md) for role-based recommendations, [Wor
|
||||
|
||||
## Best Skills By Tool
|
||||
|
||||
If you want a faster answer than "browse all 1,379+ skills", start with a tool-specific guide:
|
||||
If you want a faster answer than "browse all 1,381+ skills", start with a tool-specific guide:
|
||||
|
||||
- **[Claude Code skills](docs/users/claude-code-skills.md)**: install paths, starter skills, prompt examples, and plugin marketplace flow.
|
||||
- **[Cursor skills](docs/users/cursor-skills.md)**: best starter skills for `.cursor/skills/`, UI-heavy work, and pair-programming flows.
|
||||
@@ -183,7 +183,7 @@ If Antigravity starts hitting context limits with too many active skills, the ac
|
||||
|
||||
If you use OpenCode or another `.agents/skills` host, prefer a reduced install up front instead of copying the full library into a context-sensitive runtime. The installer now supports `--risk`, `--category`, and `--tags` so you can keep the installed set narrow.
|
||||
|
||||
## Browse 1,379+ Skills
|
||||
## Browse 1,381+ Skills
|
||||
|
||||
Use the root repo as a landing page, then jump into the deeper surface that matches your intent.
|
||||
|
||||
|
||||
@@ -12,6 +12,18 @@
|
||||
<changefreq>weekly</changefreq>
|
||||
<priority>0.7</priority>
|
||||
</url>
|
||||
<url>
|
||||
<loc>http://localhost/skill/faf-expert</loc>
|
||||
<lastmod>2026-04-07</lastmod>
|
||||
<changefreq>weekly</changefreq>
|
||||
<priority>0.7</priority>
|
||||
</url>
|
||||
<url>
|
||||
<loc>http://localhost/skill/faf-wizard</loc>
|
||||
<lastmod>2026-04-07</lastmod>
|
||||
<changefreq>weekly</changefreq>
|
||||
<priority>0.7</priority>
|
||||
</url>
|
||||
<url>
|
||||
<loc>http://localhost/skill/idea-darwin</loc>
|
||||
<lastmod>2026-04-07</lastmod>
|
||||
@@ -234,16 +246,4 @@
|
||||
<changefreq>weekly</changefreq>
|
||||
<priority>0.7</priority>
|
||||
</url>
|
||||
<url>
|
||||
<loc>http://localhost/skill/viboscope</loc>
|
||||
<lastmod>2026-04-07</lastmod>
|
||||
<changefreq>weekly</changefreq>
|
||||
<priority>0.7</priority>
|
||||
</url>
|
||||
<url>
|
||||
<loc>http://localhost/skill/jq</loc>
|
||||
<lastmod>2026-04-07</lastmod>
|
||||
<changefreq>weekly</changefreq>
|
||||
<priority>0.7</priority>
|
||||
</url>
|
||||
</urlset>
|
||||
|
||||
@@ -11755,6 +11755,50 @@
|
||||
"reasons": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "faf-expert",
|
||||
"path": "skills/faf-expert",
|
||||
"category": "coding",
|
||||
"name": "faf-expert",
|
||||
"description": "Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-04-07",
|
||||
"plugin": {
|
||||
"targets": {
|
||||
"codex": "supported",
|
||||
"claude": "supported"
|
||||
},
|
||||
"setup": {
|
||||
"type": "none",
|
||||
"summary": "",
|
||||
"docs": null
|
||||
},
|
||||
"reasons": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "faf-wizard",
|
||||
"path": "skills/faf-wizard",
|
||||
"category": "productivity",
|
||||
"name": "faf-wizard",
|
||||
"description": "Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-04-07",
|
||||
"plugin": {
|
||||
"targets": {
|
||||
"codex": "supported",
|
||||
"claude": "supported"
|
||||
},
|
||||
"setup": {
|
||||
"type": "none",
|
||||
"summary": "",
|
||||
"docs": null
|
||||
},
|
||||
"reasons": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "fal-audio",
|
||||
"path": "skills/fal-audio",
|
||||
|
||||
@@ -816,6 +816,7 @@
|
||||
"e2e-testing",
|
||||
"email-sequence",
|
||||
"expo-cicd-workflows",
|
||||
"faf-wizard",
|
||||
"fal-workflow",
|
||||
"figma-automation",
|
||||
"freshdesk-automation",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"generatedAt": "2026-02-08T00:00:00.000Z",
|
||||
"total": 1379,
|
||||
"total": 1381,
|
||||
"skills": [
|
||||
{
|
||||
"id": "00-andruia-consultant",
|
||||
@@ -12981,6 +12981,62 @@
|
||||
],
|
||||
"path": "skills/expo-ui-swift-ui/SKILL.md"
|
||||
},
|
||||
{
|
||||
"id": "faf-expert",
|
||||
"name": "faf-expert",
|
||||
"description": "Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync.",
|
||||
"category": "data-ai",
|
||||
"tags": [
|
||||
"faf",
|
||||
"ai-context",
|
||||
"project-management",
|
||||
"mcp",
|
||||
"iana"
|
||||
],
|
||||
"triggers": [
|
||||
"faf",
|
||||
"ai-context",
|
||||
"project-management",
|
||||
"mcp",
|
||||
"iana",
|
||||
"foundational",
|
||||
"ai",
|
||||
"context",
|
||||
"format",
|
||||
"registered",
|
||||
"server",
|
||||
"config"
|
||||
],
|
||||
"path": "skills/faf-expert/SKILL.md"
|
||||
},
|
||||
{
|
||||
"id": "faf-wizard",
|
||||
"name": "faf-wizard",
|
||||
"description": "Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere.",
|
||||
"category": "data-ai",
|
||||
"tags": [
|
||||
"faf",
|
||||
"automation",
|
||||
"project-setup",
|
||||
"ai-context",
|
||||
"productivity"
|
||||
],
|
||||
"triggers": [
|
||||
"faf",
|
||||
"automation",
|
||||
"project-setup",
|
||||
"ai-context",
|
||||
"productivity",
|
||||
"wizard",
|
||||
"done",
|
||||
"generator",
|
||||
"one",
|
||||
"click",
|
||||
"ai",
|
||||
"context"
|
||||
],
|
||||
"path": "skills/faf-wizard/SKILL.md"
|
||||
},
|
||||
{
|
||||
"id": "fal-audio",
|
||||
"name": "fal-audio",
|
||||
|
||||
@@ -10053,6 +10053,44 @@
|
||||
},
|
||||
"runtime_files": []
|
||||
},
|
||||
{
|
||||
"id": "faf-expert",
|
||||
"path": "skills/faf-expert",
|
||||
"targets": {
|
||||
"codex": "supported",
|
||||
"claude": "supported"
|
||||
},
|
||||
"setup": {
|
||||
"type": "none",
|
||||
"summary": "",
|
||||
"docs": null
|
||||
},
|
||||
"reasons": [],
|
||||
"blocked_reasons": {
|
||||
"codex": [],
|
||||
"claude": []
|
||||
},
|
||||
"runtime_files": []
|
||||
},
|
||||
{
|
||||
"id": "faf-wizard",
|
||||
"path": "skills/faf-wizard",
|
||||
"targets": {
|
||||
"codex": "supported",
|
||||
"claude": "supported"
|
||||
},
|
||||
"setup": {
|
||||
"type": "none",
|
||||
"summary": "",
|
||||
"docs": null
|
||||
},
|
||||
"reasons": [],
|
||||
"blocked_reasons": {
|
||||
"codex": [],
|
||||
"claude": []
|
||||
},
|
||||
"runtime_files": []
|
||||
},
|
||||
{
|
||||
"id": "fal-audio",
|
||||
"path": "skills/fal-audio",
|
||||
@@ -26363,10 +26401,10 @@
|
||||
}
|
||||
],
|
||||
"summary": {
|
||||
"total_skills": 1379,
|
||||
"total_skills": 1381,
|
||||
"supported": {
|
||||
"codex": 1350,
|
||||
"claude": 1365
|
||||
"codex": 1352,
|
||||
"claude": 1367
|
||||
},
|
||||
"blocked": {
|
||||
"codex": 29,
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
title: Jetski/Cortex + Gemini Integration Guide
|
||||
description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1.379+ skills."
|
||||
description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1.381+ skills."
|
||||
---
|
||||
|
||||
# Jetski/Cortex + Gemini: safe integration with 1,1.379+ skills
|
||||
# Jetski/Cortex + Gemini: safe integration with 1,1.381+ skills
|
||||
|
||||
This guide shows how to integrate the `antigravity-awesome-skills` repository with an agent based on **Jetski/Cortex + Gemini** (or similar frameworks) **without exceeding the model context window**.
|
||||
|
||||
@@ -23,7 +23,7 @@ Never do:
|
||||
- concatenate all `SKILL.md` content into a single system prompt;
|
||||
- re-inject the entire library for **every** request.
|
||||
|
||||
With over 1,1.379 skills, this approach fills the context window before user messages are even added, causing truncation.
|
||||
With over 1,1.381 skills, this approach fills the context window before user messages are even added, causing truncation.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ This example shows one way to integrate **antigravity-awesome-skills** with a Je
|
||||
- How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
|
||||
- How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.
|
||||
|
||||
This pattern avoids context overflow when you have 1,379+ skills installed.
|
||||
This pattern avoids context overflow when you have 1,381+ skills installed.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@ This document keeps the repository's GitHub-facing discovery copy aligned with t
|
||||
|
||||
Preferred positioning:
|
||||
|
||||
> Installable GitHub library of 1,379+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
|
||||
> Installable GitHub library of 1,381+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
|
||||
|
||||
Key framing:
|
||||
|
||||
@@ -20,7 +20,7 @@ Key framing:
|
||||
|
||||
Preferred description:
|
||||
|
||||
> Installable GitHub library of 1,379+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
|
||||
> Installable GitHub library of 1,381+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
|
||||
|
||||
Preferred homepage:
|
||||
|
||||
@@ -28,7 +28,7 @@ Preferred homepage:
|
||||
|
||||
Preferred social preview:
|
||||
|
||||
- use a clean preview image that says `1,379+ Agentic Skills`;
|
||||
- use a clean preview image that says `1,381+ Agentic Skills`;
|
||||
- mention Claude Code, Cursor, Codex CLI, and Gemini CLI;
|
||||
- avoid dense text and tiny logos that disappear in social cards.
|
||||
|
||||
|
||||
@@ -69,7 +69,7 @@ For manual updates, you need:
|
||||
The update process refreshes:
|
||||
- Skills index (`skills_index.json`)
|
||||
- Web app skills data (`apps\web-app\public\skills.json`)
|
||||
- All 1,379+ skills from the skills directory
|
||||
- All 1,381+ skills from the skills directory
|
||||
|
||||
## When to Update
|
||||
|
||||
|
||||
@@ -673,4 +673,4 @@ Found a skill that should be in a bundle? Or want to create a new bundle? [Open
|
||||
|
||||
---
|
||||
|
||||
_Last updated: March 2026 | Total Skills: 1,379+ | Total Bundles: 37_
|
||||
_Last updated: March 2026 | Total Skills: 1,381+ | Total Bundles: 37_
|
||||
|
||||
@@ -12,7 +12,7 @@ Install the library into Claude Code, then invoke focused skills directly in the
|
||||
|
||||
## Why use this repo for Claude Code
|
||||
|
||||
- It includes 1,379+ skills instead of a narrow single-domain starter pack.
|
||||
- It includes 1,381+ skills instead of a narrow single-domain starter pack.
|
||||
- It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
|
||||
- It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
|
||||
- It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
|
||||
|
||||
@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim
|
||||
|
||||
- It installs directly into the expected Gemini skills path.
|
||||
- It includes both core software engineering skills and deeper agent/LLM-oriented skills.
|
||||
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,379+ files.
|
||||
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,381+ files.
|
||||
- It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
|
||||
|
||||
## Install Gemini CLI Skills
|
||||
|
||||
@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
|
||||
|
||||
Kiro's agentic capabilities are enhanced by skills that provide:
|
||||
|
||||
- **Domain expertise** across 1,379+ specialized areas
|
||||
- **Domain expertise** across 1,381+ specialized areas
|
||||
- **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
|
||||
- **Workflow automation** for common development tasks
|
||||
- **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
|
||||
|
||||
@@ -14,7 +14,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of a full l
|
||||
|
||||
When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
|
||||
|
||||
✅ **Downloaded 1,379+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
|
||||
✅ **Downloaded 1,381+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
|
||||
✅ **Made them available** to your AI assistant
|
||||
❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
|
||||
|
||||
@@ -34,7 +34,7 @@ Bundles are **curated groups** of skills organized by role. They help you decide
|
||||
|
||||
**Analogy:**
|
||||
|
||||
- You installed a toolbox with 1,379+ tools (✅ done)
|
||||
- You installed a toolbox with 1,381+ tools (✅ done)
|
||||
- Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
|
||||
- You can either **pick skills from the tray** or install that tray as a focused marketplace bundle plugin
|
||||
|
||||
@@ -212,7 +212,7 @@ Let's actually use a skill right now. Follow these steps:
|
||||
|
||||
## Step 5: Picking Your First Skills (Practical Advice)
|
||||
|
||||
Don't try to use all 1,379+ skills at once. Here's a sensible approach:
|
||||
Don't try to use all 1,381+ skills at once. Here's a sensible approach:
|
||||
|
||||
If you want a tool-specific starting point before choosing skills, use:
|
||||
|
||||
@@ -343,7 +343,7 @@ Usually no, but if your AI doesn't recognize a skill:
|
||||
|
||||
### "Can I load all skills into the model at once?"
|
||||
|
||||
No. Even though you have 1,379+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
|
||||
No. Even though you have 1,381+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
|
||||
|
||||
The intended pattern is:
|
||||
|
||||
|
||||
@@ -34,7 +34,7 @@ antigravity-awesome-skills/
|
||||
├── 📄 CONTRIBUTING.md ← Contributor workflow
|
||||
├── 📄 CATALOG.md ← Full generated catalog
|
||||
│
|
||||
├── 📁 skills/ ← 1,379+ skills live here
|
||||
├── 📁 skills/ ← 1,381+ skills live here
|
||||
│ │
|
||||
│ ├── 📁 brainstorming/
|
||||
│ │ └── 📄 SKILL.md ← Skill definition
|
||||
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
|
||||
│ │ └── 📁 2d-games/
|
||||
│ │ └── 📄 SKILL.md ← Nested skills also supported
|
||||
│ │
|
||||
│ └── ... (1,379+ total)
|
||||
│ └── ... (1,381+ total)
|
||||
│
|
||||
├── 📁 apps/
|
||||
│ └── 📁 web-app/ ← Interactive browser
|
||||
@@ -100,7 +100,7 @@ antigravity-awesome-skills/
|
||||
|
||||
```
|
||||
┌─────────────────────────┐
|
||||
│ 1,379+ SKILLS │
|
||||
│ 1,381+ SKILLS │
|
||||
└────────────┬────────────┘
|
||||
│
|
||||
┌────────────────────────┼────────────────────────┐
|
||||
@@ -201,7 +201,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
|
||||
│ ├── 📁 brainstorming/ │
|
||||
│ ├── 📁 stripe-integration/ │
|
||||
│ ├── 📁 react-best-practices/ │
|
||||
│ └── ... (1,379+ total) │
|
||||
│ └── ... (1,381+ total) │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "antigravity-awesome-skills",
|
||||
"version": "9.8.0",
|
||||
"description": "1,379+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
|
||||
"description": "1,381+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
|
||||
"license": "MIT",
|
||||
"scripts": {
|
||||
"validate": "node tools/scripts/run-python.js tools/scripts/validate_skills.py",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "antigravity-awesome-skills",
|
||||
"version": "9.8.0",
|
||||
"description": "Plugin-safe Claude Code distribution of Antigravity Awesome Skills with 1,365 supported skills.",
|
||||
"description": "Plugin-safe Claude Code distribution of Antigravity Awesome Skills with 1,367 supported skills.",
|
||||
"author": {
|
||||
"name": "sickn33 and contributors",
|
||||
"url": "https://github.com/sickn33/antigravity-awesome-skills"
|
||||
|
||||
@@ -0,0 +1,221 @@
|
||||
---
|
||||
name: faf-expert
|
||||
description: "Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync."
|
||||
category: coding
|
||||
risk: safe
|
||||
source: community
|
||||
source_repo: Wolfe-Jam/faf-skills
|
||||
source_type: community
|
||||
date_added: "2026-04-07"
|
||||
author: wolfejam
|
||||
tags: [faf, ai-context, project-management, mcp, iana]
|
||||
tools: [claude, cursor, gemini, windsurf]
|
||||
---
|
||||
|
||||
# FAF Expert - Advanced AI Context Architecture
|
||||
|
||||
**Master the IANA-registered format that makes AI understand your projects.**
|
||||
|
||||
Transform any codebase into an AI-intelligent project with persistent context that survives across sessions, tools, and AI platforms. Expert-level control over the foundational layer that powers modern AI development workflows.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
Use FAF Expert when you need:
|
||||
|
||||
| Scenario | What FAF Expert Provides |
|
||||
|----------|---------------------------|
|
||||
| **Complex project setup** | Expert configuration of .faf files and MCP servers |
|
||||
| **Championship scoring** | Achieve 85%+ AI-readiness scores for production projects |
|
||||
| **Multi-AI workflows** | Universal context that works across Claude, Cursor, Gemini, Windsurf |
|
||||
| **Legacy codebase revival** | Transform archaeology into AI-readable project DNA |
|
||||
| **Team collaboration** | Standardized context format for consistent AI assistance |
|
||||
| **Enterprise deployment** | Professional MCP server configuration and management |
|
||||
|
||||
## Real-World Examples
|
||||
|
||||
### Example 1: Legacy Enterprise Java System
|
||||
```yaml
|
||||
# Achieved: 92% Gold tier with FAF Expert
|
||||
project:
|
||||
name: enterprise-payment-api
|
||||
goal: Mission-critical payment processing system
|
||||
|
||||
stack:
|
||||
backend: java-spring
|
||||
database: oracle
|
||||
runtime: java-11
|
||||
deployment: kubernetes
|
||||
|
||||
human_context:
|
||||
where: AWS EKS production cluster
|
||||
when: Legacy system from 2018, modernizing 2026
|
||||
how: Spring Boot 2.7, Oracle 19c, Docker containerization
|
||||
```
|
||||
|
||||
### Example 2: Modern React Dashboard
|
||||
```yaml
|
||||
# Achieved: 97% Gold tier performance
|
||||
project:
|
||||
name: analytics-dashboard
|
||||
goal: Real-time analytics for SaaS platform
|
||||
|
||||
stack:
|
||||
frontend: react-18
|
||||
css_framework: tailwind
|
||||
state: zustand
|
||||
build: vite
|
||||
testing: vitest
|
||||
deployment: vercel
|
||||
```
|
||||
|
||||
## Core Capabilities
|
||||
|
||||
### 🏆 Championship Scoring System
|
||||
- **Gold Tier (95%+)**: Production-ready AI context
|
||||
- **Silver Tier (85%+)**: Professional development standard
|
||||
- **Bronze Tier (70%+)**: Solid foundation for AI assistance
|
||||
|
||||
### 🔧 MCP Server Configuration
|
||||
Expert setup of claude-faf-mcp with 33 tools:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"faf": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "claude-faf-mcp@latest"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 🔄 Bi-Directional Sync
|
||||
Keep context synchronized across platforms:
|
||||
- `.faf` ↔ `CLAUDE.md`
|
||||
- `.faf` ↔ `.cursorrules`
|
||||
- `.faf` ↔ `GEMINI.md`
|
||||
- `.faf` ↔ `AGENTS.md`
|
||||
|
||||
### 📊 Mk4 Architecture Framework
|
||||
33-slot IANA format for comprehensive project context:
|
||||
- Project identity and goals
|
||||
- Technical stack detection
|
||||
- Human context (who/what/why/where/when/how)
|
||||
- Architecture patterns
|
||||
- Deployment configuration
|
||||
|
||||
## Getting Started
|
||||
|
||||
### Quick Installation
|
||||
```bash
|
||||
# Install FAF CLI
|
||||
npm install -g faf-cli
|
||||
|
||||
# Initialize your project
|
||||
faf init
|
||||
|
||||
# Score AI-readiness
|
||||
faf score --details
|
||||
|
||||
# Set up MCP server
|
||||
faf mcp install
|
||||
```
|
||||
|
||||
### Expert Commands
|
||||
```bash
|
||||
# Advanced scoring with breakdown
|
||||
faf score --championship --verbose
|
||||
|
||||
# Multi-platform sync
|
||||
faf bi-sync --target all
|
||||
|
||||
# Validate format compliance
|
||||
faf validate --strict
|
||||
|
||||
# Enhanced AI optimization
|
||||
faf enhance --model claude --focus completeness
|
||||
```
|
||||
|
||||
## Success Metrics
|
||||
|
||||
**Real Performance Data:**
|
||||
- **52k+ downloads** across FAF ecosystem
|
||||
- **800+ comprehensive tests** (CLI + MCP)
|
||||
- **IANA-registered format** (application/vnd.faf+yaml)
|
||||
- **153+ validated formats** supported
|
||||
- **Championship-grade performance** (<50ms execution)
|
||||
|
||||
## Platform Compatibility
|
||||
|
||||
### Supported AI Tools
|
||||
- ✅ **Claude Code** - Native MCP integration
|
||||
- ✅ **Cursor** - .cursorrules sync
|
||||
- ✅ **Gemini CLI** - GEMINI.md sync
|
||||
- ✅ **Windsurf** - .windsurfrules support
|
||||
- ✅ **Universal** - Works with any AI that reads YAML
|
||||
|
||||
### MCP Servers Available
|
||||
- `claude-faf-mcp` - 33 tools, 391 tests
|
||||
- `grok-faf-mcp` - xAI/Grok optimized
|
||||
- `rust-faf-mcp` - Native performance (4.3MB binary)
|
||||
- `gemini-faf-mcp` - Google Gemini integration
|
||||
|
||||
## Advanced Patterns
|
||||
|
||||
### Enterprise Configuration
|
||||
```yaml
|
||||
faf_version: "3.0"
|
||||
project:
|
||||
name: enterprise-platform
|
||||
tier: production
|
||||
|
||||
human_context:
|
||||
team_size: 50+
|
||||
compliance: SOC2, HIPAA
|
||||
deployment: multi-region
|
||||
|
||||
stack:
|
||||
architecture: microservices
|
||||
orchestration: kubernetes
|
||||
monitoring: datadog
|
||||
security: vault
|
||||
```
|
||||
|
||||
### Legacy System Revival
|
||||
```yaml
|
||||
# Transform 10-year-old codebase to AI-ready
|
||||
project:
|
||||
archaeology: true
|
||||
modernization_target: 2026
|
||||
|
||||
stack:
|
||||
legacy: php-5.6
|
||||
migration_path: laravel-11
|
||||
database_upgrade: mysql-8
|
||||
```
|
||||
|
||||
## Expert Resources
|
||||
|
||||
- **Documentation**: https://faf.one
|
||||
- **MCP Registry**: Official Anthropic steward
|
||||
- **CLI Reference**: `faf --help`
|
||||
- **Community**: Discord server with 1000+ developers
|
||||
- **Enterprise**: Professional support available
|
||||
|
||||
## When to Use faf-wizard Instead
|
||||
|
||||
Use `faf-wizard` for:
|
||||
- ✅ Quick project setup
|
||||
- ✅ One-click generation
|
||||
- ✅ Beginner-friendly workflow
|
||||
- ✅ Automated stack detection
|
||||
|
||||
Use `faf-expert` for:
|
||||
- 🎯 Fine-tuned configuration
|
||||
- 🎯 Championship scoring optimization
|
||||
- 🎯 Multi-platform sync management
|
||||
- 🎯 Enterprise deployment patterns
|
||||
- 🎯 Advanced MCP server setup
|
||||
|
||||
---
|
||||
|
||||
*Master the format that makes AI understand your projects. FAF Expert - for when you need championship-grade AI context architecture.*
|
||||
@@ -0,0 +1,252 @@
|
||||
---
|
||||
name: faf-wizard
|
||||
description: "Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere."
|
||||
category: productivity
|
||||
risk: safe
|
||||
source: community
|
||||
source_repo: Wolfe-Jam/faf-skills
|
||||
source_type: community
|
||||
date_added: "2026-04-07"
|
||||
author: wolfejam
|
||||
tags: [faf, automation, project-setup, ai-context, productivity]
|
||||
tools: [claude, cursor, gemini, windsurf, any-ai]
|
||||
---
|
||||
|
||||
# FAF Wizard - One-Click AI Intelligence
|
||||
|
||||
**The pit crew for your projects.** Point it at any codebase and get scored, AI-ready context in 60 seconds.
|
||||
|
||||
Transform any project - new, legacy, famous OSS, or forgotten side projects - into an AI-intelligent workspace with persistent context that works across all AI tools.
|
||||
|
||||
## The Problem It Solves
|
||||
|
||||
**Even React.js scores 0% AI-readiness.** Famous repositories have no AI context.
|
||||
|
||||
| What Exists | What It Tells AI |
|
||||
|-------------|------------------|
|
||||
| README.md | "What this does" (for humans) |
|
||||
| docs/ | "How to use it" (for humans) |
|
||||
| **project.faf** | "How to help build this" (for AI) |
|
||||
|
||||
Documentation tells humans how to use your code. AI context tells AI how to help you build it. **They're completely different things.**
|
||||
|
||||
## Works on ANY Project
|
||||
|
||||
| Project Type | What FAF Wizard Does |
|
||||
|-------------|----------------------|
|
||||
| **Brand new** | Perfect AI context from line one |
|
||||
| **Legacy nightmare** | AI finally understands the archaeology |
|
||||
| **Famous OSS** | Even React doesn't have this |
|
||||
| **Side projects** | Stop re-explaining every session |
|
||||
| **Client handoffs** | Portable context for any AI tool |
|
||||
| **Team projects** | Shared context that everyone can use |
|
||||
|
||||
## Real Success Stories
|
||||
|
||||
### Before/After: Legacy E-commerce Platform
|
||||
```
|
||||
Before: "This 50k-line PHP codebase from 2015..."
|
||||
AI: "I don't understand this architecture"
|
||||
|
||||
After: 60 seconds with FAF Wizard
|
||||
AI: "I see this is a Laravel-based e-commerce system with
|
||||
payment processing, inventory management, and multi-tenant
|
||||
architecture. Here's how I can help..."
|
||||
```
|
||||
|
||||
### Before/After: Modern React App
|
||||
```
|
||||
Before: Every AI session starts with context explanation
|
||||
Time lost: 5-10 minutes per session
|
||||
|
||||
After: project.faf exists
|
||||
AI: Instant understanding, productive from message one
|
||||
Time saved: 2+ hours per day
|
||||
```
|
||||
|
||||
## The 60-Second Workflow
|
||||
|
||||
### Step 1: Detection (10 seconds)
|
||||
```bash
|
||||
faf auto
|
||||
# Scans manifest files, directory structure, dependencies
|
||||
# Detects: React + TypeScript + Tailwind + Vercel
|
||||
```
|
||||
|
||||
### Step 2: Generation (30 seconds)
|
||||
```yaml
|
||||
# Auto-generated project.faf
|
||||
project:
|
||||
name: my-saas-dashboard
|
||||
goal: Customer analytics platform
|
||||
|
||||
stack:
|
||||
frontend: react-18
|
||||
css: tailwind
|
||||
deployment: vercel
|
||||
|
||||
human_context:
|
||||
who: Solo founder
|
||||
what: SaaS analytics dashboard
|
||||
why: Customer insights for small businesses
|
||||
```
|
||||
|
||||
### Step 3: Scoring & Report (20 seconds)
|
||||
```
|
||||
✅ Generated: project.faf
|
||||
🏆 AI-Readiness: 87% Bronze - Production ready
|
||||
|
||||
Filled: 9/11 active slots
|
||||
Ignored: 22 slots (not applicable)
|
||||
|
||||
To reach Silver (95%):
|
||||
+ Add API documentation (+5%)
|
||||
+ Define deployment details (+3%)
|
||||
```
|
||||
|
||||
## Performance Data (Real Numbers)
|
||||
|
||||
**Analyzed 8,400+ Projects:**
|
||||
- ✅ **99.2% detection accuracy** across 153+ formats
|
||||
- ✅ **Average generation time**: 12.3 seconds
|
||||
- ✅ **Bronze tier or higher**: 94% of projects
|
||||
- ✅ **Zero manual configuration**: Works out of the box
|
||||
|
||||
### Format Support
|
||||
Automatically detects and configures:
|
||||
- **JavaScript**: React, Vue, Angular, Svelte, Next.js, Nuxt
|
||||
- **Python**: Django, Flask, FastAPI, Jupyter, Poetry
|
||||
- **TypeScript**: All JS frameworks + native TS projects
|
||||
- **Rust**: Cargo projects, CLI tools, web servers
|
||||
- **Go**: Modules, Docker, microservices
|
||||
- **Java**: Maven, Gradle, Spring Boot
|
||||
- **+147 more formats**
|
||||
|
||||
## Universal Compatibility
|
||||
|
||||
### Works With Every AI Tool
|
||||
- ✅ **Claude Code** - Reads .faf natively
|
||||
- ✅ **Cursor** - Auto-syncs to .cursorrules
|
||||
- ✅ **Gemini CLI** - Converts to GEMINI.md
|
||||
- ✅ **Windsurf** - Syncs to .windsurfrules
|
||||
- ✅ **ChatGPT** - Readable YAML format
|
||||
- ✅ **Any AI** - Universal format support
|
||||
|
||||
### Migration Support
|
||||
Already have AI context files?
|
||||
```bash
|
||||
# Migrates existing context
|
||||
faf migrate --from .cursorrules
|
||||
faf migrate --from CLAUDE.md
|
||||
faf migrate --from README.md
|
||||
|
||||
# One format, works everywhere
|
||||
faf sync --target all
|
||||
```
|
||||
|
||||
## Installation Options
|
||||
|
||||
### Option 1: CLI (Recommended)
|
||||
```bash
|
||||
npm install -g faf-cli
|
||||
cd your-project
|
||||
faf auto
|
||||
```
|
||||
|
||||
### Option 2: MCP Server (Claude Code)
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"faf": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "claude-faf-mcp@latest"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Option 3: Browser Extension
|
||||
Install from Chrome Web Store - works on any Git repository.
|
||||
|
||||
## Three-Phase Intelligence
|
||||
|
||||
### Phase 1: Stack Detection
|
||||
- Scans `package.json`, `Cargo.toml`, `pyproject.toml`, etc.
|
||||
- Analyzes directory structure and file patterns
|
||||
- Identifies frameworks, deployment targets, testing setup
|
||||
|
||||
### Phase 2: Context Mining
|
||||
- Extracts project description from README
|
||||
- Identifies architecture patterns from code structure
|
||||
- Pulls dependency information for AI context
|
||||
|
||||
### Phase 3: Optimization
|
||||
- Generates focused 33-slot IANA format
|
||||
- Validates against format specification
|
||||
- Scores AI-readiness with improvement suggestions
|
||||
|
||||
## Success Metrics by Project Type
|
||||
|
||||
| Project Type | Avg Score | Time to Bronze | Detection Rate |
|
||||
|-------------|-----------|----------------|----------------|
|
||||
| **React/Vue** | 89% | Instant | 99.8% |
|
||||
| **Python Django** | 91% | Instant | 99.5% |
|
||||
| **Rust CLI** | 85% | Instant | 99.1% |
|
||||
| **Legacy PHP** | 76% | 30 seconds | 94.2% |
|
||||
| **Monorepo** | 82% | 45 seconds | 91.8% |
|
||||
|
||||
## When to Use faf-expert Instead
|
||||
|
||||
Use `faf-wizard` for:
|
||||
- ✅ Quick project onboarding
|
||||
- ✅ Automatic everything
|
||||
- ✅ "Just make it work"
|
||||
- ✅ Time-constrained scenarios
|
||||
|
||||
Use `faf-expert` for:
|
||||
- 🎯 Fine-tuned championship scoring (95%+)
|
||||
- 🎯 Complex MCP server configuration
|
||||
- 🎯 Multi-platform sync management
|
||||
- 🎯 Enterprise deployment patterns
|
||||
|
||||
## Validation & Security
|
||||
|
||||
**Enterprise-Grade Standards:**
|
||||
- ✅ **800+ comprehensive tests** across CLI and MCP
|
||||
- ✅ **No credentials ever stored** in .faf files
|
||||
- ✅ **YAML format validation** prevents malformed files
|
||||
- ✅ **IANA-registered format** (application/vnd.faf+yaml)
|
||||
- ✅ **MIT licensed** - safe for commercial use
|
||||
|
||||
## Getting Started
|
||||
|
||||
### For Your Current Project
|
||||
```bash
|
||||
# One command, done forever
|
||||
npx faf-cli auto
|
||||
|
||||
# Check the results
|
||||
cat project.faf
|
||||
```
|
||||
|
||||
### For Any GitHub Repository
|
||||
Install the browser extension and click "Generate FAF" on any repo.
|
||||
|
||||
### For Teams
|
||||
```bash
|
||||
# Set up team-wide MCP server
|
||||
faf mcp install --team
|
||||
faf sync --target all --watch
|
||||
```
|
||||
|
||||
## Community & Support
|
||||
|
||||
- **Website**: https://faf.one
|
||||
- **Chrome Extension**: 4.8★ rating, Google approved
|
||||
- **Downloads**: 52k+ across ecosystem
|
||||
- **Discord**: Active community of 1000+ developers
|
||||
- **Documentation**: Comprehensive guides and examples
|
||||
|
||||
---
|
||||
|
||||
*Stop explaining your project every session. FAF Wizard - because AI should understand your project as well as you do.*
|
||||
@@ -19,7 +19,7 @@
|
||||
"skills": "./skills/",
|
||||
"interface": {
|
||||
"displayName": "Antigravity Awesome Skills",
|
||||
"shortDescription": "1,350 plugin-safe skills for coding, security, product, and ops workflows.",
|
||||
"shortDescription": "1,352 plugin-safe skills for coding, security, product, and ops workflows.",
|
||||
"longDescription": "Install a plugin-safe Codex distribution of Antigravity Awesome Skills. Skills that still need hardening or target-specific setup remain available in the repo but are excluded from this plugin.",
|
||||
"developerName": "sickn33 and contributors",
|
||||
"category": "Productivity",
|
||||
|
||||
221
plugins/antigravity-awesome-skills/skills/faf-expert/SKILL.md
Normal file
221
plugins/antigravity-awesome-skills/skills/faf-expert/SKILL.md
Normal file
@@ -0,0 +1,221 @@
|
||||
---
|
||||
name: faf-expert
|
||||
description: "Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync."
|
||||
category: coding
|
||||
risk: safe
|
||||
source: community
|
||||
source_repo: Wolfe-Jam/faf-skills
|
||||
source_type: community
|
||||
date_added: "2026-04-07"
|
||||
author: wolfejam
|
||||
tags: [faf, ai-context, project-management, mcp, iana]
|
||||
tools: [claude, cursor, gemini, windsurf]
|
||||
---
|
||||
|
||||
# FAF Expert - Advanced AI Context Architecture
|
||||
|
||||
**Master the IANA-registered format that makes AI understand your projects.**
|
||||
|
||||
Transform any codebase into an AI-intelligent project with persistent context that survives across sessions, tools, and AI platforms. Expert-level control over the foundational layer that powers modern AI development workflows.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
Use FAF Expert when you need:
|
||||
|
||||
| Scenario | What FAF Expert Provides |
|
||||
|----------|---------------------------|
|
||||
| **Complex project setup** | Expert configuration of .faf files and MCP servers |
|
||||
| **Championship scoring** | Achieve 85%+ AI-readiness scores for production projects |
|
||||
| **Multi-AI workflows** | Universal context that works across Claude, Cursor, Gemini, Windsurf |
|
||||
| **Legacy codebase revival** | Transform archaeology into AI-readable project DNA |
|
||||
| **Team collaboration** | Standardized context format for consistent AI assistance |
|
||||
| **Enterprise deployment** | Professional MCP server configuration and management |
|
||||
|
||||
## Real-World Examples
|
||||
|
||||
### Example 1: Legacy Enterprise Java System
|
||||
```yaml
|
||||
# Achieved: 92% Gold tier with FAF Expert
|
||||
project:
|
||||
name: enterprise-payment-api
|
||||
goal: Mission-critical payment processing system
|
||||
|
||||
stack:
|
||||
backend: java-spring
|
||||
database: oracle
|
||||
runtime: java-11
|
||||
deployment: kubernetes
|
||||
|
||||
human_context:
|
||||
where: AWS EKS production cluster
|
||||
when: Legacy system from 2018, modernizing 2026
|
||||
how: Spring Boot 2.7, Oracle 19c, Docker containerization
|
||||
```
|
||||
|
||||
### Example 2: Modern React Dashboard
|
||||
```yaml
|
||||
# Achieved: 97% Gold tier performance
|
||||
project:
|
||||
name: analytics-dashboard
|
||||
goal: Real-time analytics for SaaS platform
|
||||
|
||||
stack:
|
||||
frontend: react-18
|
||||
css_framework: tailwind
|
||||
state: zustand
|
||||
build: vite
|
||||
testing: vitest
|
||||
deployment: vercel
|
||||
```
|
||||
|
||||
## Core Capabilities
|
||||
|
||||
### 🏆 Championship Scoring System
|
||||
- **Gold Tier (95%+)**: Production-ready AI context
|
||||
- **Silver Tier (85%+)**: Professional development standard
|
||||
- **Bronze Tier (70%+)**: Solid foundation for AI assistance
|
||||
|
||||
### 🔧 MCP Server Configuration
|
||||
Expert setup of claude-faf-mcp with 33 tools:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"faf": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "claude-faf-mcp@latest"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 🔄 Bi-Directional Sync
|
||||
Keep context synchronized across platforms:
|
||||
- `.faf` ↔ `CLAUDE.md`
|
||||
- `.faf` ↔ `.cursorrules`
|
||||
- `.faf` ↔ `GEMINI.md`
|
||||
- `.faf` ↔ `AGENTS.md`
|
||||
|
||||
### 📊 Mk4 Architecture Framework
|
||||
33-slot IANA format for comprehensive project context:
|
||||
- Project identity and goals
|
||||
- Technical stack detection
|
||||
- Human context (who/what/why/where/when/how)
|
||||
- Architecture patterns
|
||||
- Deployment configuration
|
||||
|
||||
## Getting Started
|
||||
|
||||
### Quick Installation
|
||||
```bash
|
||||
# Install FAF CLI
|
||||
npm install -g faf-cli
|
||||
|
||||
# Initialize your project
|
||||
faf init
|
||||
|
||||
# Score AI-readiness
|
||||
faf score --details
|
||||
|
||||
# Set up MCP server
|
||||
faf mcp install
|
||||
```
|
||||
|
||||
### Expert Commands
|
||||
```bash
|
||||
# Advanced scoring with breakdown
|
||||
faf score --championship --verbose
|
||||
|
||||
# Multi-platform sync
|
||||
faf bi-sync --target all
|
||||
|
||||
# Validate format compliance
|
||||
faf validate --strict
|
||||
|
||||
# Enhanced AI optimization
|
||||
faf enhance --model claude --focus completeness
|
||||
```
|
||||
|
||||
## Success Metrics
|
||||
|
||||
**Real Performance Data:**
|
||||
- **52k+ downloads** across FAF ecosystem
|
||||
- **800+ comprehensive tests** (CLI + MCP)
|
||||
- **IANA-registered format** (application/vnd.faf+yaml)
|
||||
- **153+ validated formats** supported
|
||||
- **Championship-grade performance** (<50ms execution)
|
||||
|
||||
## Platform Compatibility
|
||||
|
||||
### Supported AI Tools
|
||||
- ✅ **Claude Code** - Native MCP integration
|
||||
- ✅ **Cursor** - .cursorrules sync
|
||||
- ✅ **Gemini CLI** - GEMINI.md sync
|
||||
- ✅ **Windsurf** - .windsurfrules support
|
||||
- ✅ **Universal** - Works with any AI that reads YAML
|
||||
|
||||
### MCP Servers Available
|
||||
- `claude-faf-mcp` - 33 tools, 391 tests
|
||||
- `grok-faf-mcp` - xAI/Grok optimized
|
||||
- `rust-faf-mcp` - Native performance (4.3MB binary)
|
||||
- `gemini-faf-mcp` - Google Gemini integration
|
||||
|
||||
## Advanced Patterns
|
||||
|
||||
### Enterprise Configuration
|
||||
```yaml
|
||||
faf_version: "3.0"
|
||||
project:
|
||||
name: enterprise-platform
|
||||
tier: production
|
||||
|
||||
human_context:
|
||||
team_size: 50+
|
||||
compliance: SOC2, HIPAA
|
||||
deployment: multi-region
|
||||
|
||||
stack:
|
||||
architecture: microservices
|
||||
orchestration: kubernetes
|
||||
monitoring: datadog
|
||||
security: vault
|
||||
```
|
||||
|
||||
### Legacy System Revival
|
||||
```yaml
|
||||
# Transform 10-year-old codebase to AI-ready
|
||||
project:
|
||||
archaeology: true
|
||||
modernization_target: 2026
|
||||
|
||||
stack:
|
||||
legacy: php-5.6
|
||||
migration_path: laravel-11
|
||||
database_upgrade: mysql-8
|
||||
```
|
||||
|
||||
## Expert Resources
|
||||
|
||||
- **Documentation**: https://faf.one
|
||||
- **MCP Registry**: Official Anthropic steward
|
||||
- **CLI Reference**: `faf --help`
|
||||
- **Community**: Discord server with 1000+ developers
|
||||
- **Enterprise**: Professional support available
|
||||
|
||||
## When to Use faf-wizard Instead
|
||||
|
||||
Use `faf-wizard` for:
|
||||
- ✅ Quick project setup
|
||||
- ✅ One-click generation
|
||||
- ✅ Beginner-friendly workflow
|
||||
- ✅ Automated stack detection
|
||||
|
||||
Use `faf-expert` for:
|
||||
- 🎯 Fine-tuned configuration
|
||||
- 🎯 Championship scoring optimization
|
||||
- 🎯 Multi-platform sync management
|
||||
- 🎯 Enterprise deployment patterns
|
||||
- 🎯 Advanced MCP server setup
|
||||
|
||||
---
|
||||
|
||||
*Master the format that makes AI understand your projects. FAF Expert - for when you need championship-grade AI context architecture.*
|
||||
252
plugins/antigravity-awesome-skills/skills/faf-wizard/SKILL.md
Normal file
252
plugins/antigravity-awesome-skills/skills/faf-wizard/SKILL.md
Normal file
@@ -0,0 +1,252 @@
|
||||
---
|
||||
name: faf-wizard
|
||||
description: "Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere."
|
||||
category: productivity
|
||||
risk: safe
|
||||
source: community
|
||||
source_repo: Wolfe-Jam/faf-skills
|
||||
source_type: community
|
||||
date_added: "2026-04-07"
|
||||
author: wolfejam
|
||||
tags: [faf, automation, project-setup, ai-context, productivity]
|
||||
tools: [claude, cursor, gemini, windsurf, any-ai]
|
||||
---
|
||||
|
||||
# FAF Wizard - One-Click AI Intelligence
|
||||
|
||||
**The pit crew for your projects.** Point it at any codebase and get scored, AI-ready context in 60 seconds.
|
||||
|
||||
Transform any project - new, legacy, famous OSS, or forgotten side projects - into an AI-intelligent workspace with persistent context that works across all AI tools.
|
||||
|
||||
## The Problem It Solves
|
||||
|
||||
**Even React.js scores 0% AI-readiness.** Famous repositories have no AI context.
|
||||
|
||||
| What Exists | What It Tells AI |
|
||||
|-------------|------------------|
|
||||
| README.md | "What this does" (for humans) |
|
||||
| docs/ | "How to use it" (for humans) |
|
||||
| **project.faf** | "How to help build this" (for AI) |
|
||||
|
||||
Documentation tells humans how to use your code. AI context tells AI how to help you build it. **They're completely different things.**
|
||||
|
||||
## Works on ANY Project
|
||||
|
||||
| Project Type | What FAF Wizard Does |
|
||||
|-------------|----------------------|
|
||||
| **Brand new** | Perfect AI context from line one |
|
||||
| **Legacy nightmare** | AI finally understands the archaeology |
|
||||
| **Famous OSS** | Even React doesn't have this |
|
||||
| **Side projects** | Stop re-explaining every session |
|
||||
| **Client handoffs** | Portable context for any AI tool |
|
||||
| **Team projects** | Shared context that everyone can use |
|
||||
|
||||
## Real Success Stories
|
||||
|
||||
### Before/After: Legacy E-commerce Platform
|
||||
```
|
||||
Before: "This 50k-line PHP codebase from 2015..."
|
||||
AI: "I don't understand this architecture"
|
||||
|
||||
After: 60 seconds with FAF Wizard
|
||||
AI: "I see this is a Laravel-based e-commerce system with
|
||||
payment processing, inventory management, and multi-tenant
|
||||
architecture. Here's how I can help..."
|
||||
```
|
||||
|
||||
### Before/After: Modern React App
|
||||
```
|
||||
Before: Every AI session starts with context explanation
|
||||
Time lost: 5-10 minutes per session
|
||||
|
||||
After: project.faf exists
|
||||
AI: Instant understanding, productive from message one
|
||||
Time saved: 2+ hours per day
|
||||
```
|
||||
|
||||
## The 60-Second Workflow
|
||||
|
||||
### Step 1: Detection (10 seconds)
|
||||
```bash
|
||||
faf auto
|
||||
# Scans manifest files, directory structure, dependencies
|
||||
# Detects: React + TypeScript + Tailwind + Vercel
|
||||
```
|
||||
|
||||
### Step 2: Generation (30 seconds)
|
||||
```yaml
|
||||
# Auto-generated project.faf
|
||||
project:
|
||||
name: my-saas-dashboard
|
||||
goal: Customer analytics platform
|
||||
|
||||
stack:
|
||||
frontend: react-18
|
||||
css: tailwind
|
||||
deployment: vercel
|
||||
|
||||
human_context:
|
||||
who: Solo founder
|
||||
what: SaaS analytics dashboard
|
||||
why: Customer insights for small businesses
|
||||
```
|
||||
|
||||
### Step 3: Scoring & Report (20 seconds)
|
||||
```
|
||||
✅ Generated: project.faf
|
||||
🏆 AI-Readiness: 87% Bronze - Production ready
|
||||
|
||||
Filled: 9/11 active slots
|
||||
Ignored: 22 slots (not applicable)
|
||||
|
||||
To reach Silver (95%):
|
||||
+ Add API documentation (+5%)
|
||||
+ Define deployment details (+3%)
|
||||
```
|
||||
|
||||
## Performance Data (Real Numbers)
|
||||
|
||||
**Analyzed 8,400+ Projects:**
|
||||
- ✅ **99.2% detection accuracy** across 153+ formats
|
||||
- ✅ **Average generation time**: 12.3 seconds
|
||||
- ✅ **Bronze tier or higher**: 94% of projects
|
||||
- ✅ **Zero manual configuration**: Works out of the box
|
||||
|
||||
### Format Support
|
||||
Automatically detects and configures:
|
||||
- **JavaScript**: React, Vue, Angular, Svelte, Next.js, Nuxt
|
||||
- **Python**: Django, Flask, FastAPI, Jupyter, Poetry
|
||||
- **TypeScript**: All JS frameworks + native TS projects
|
||||
- **Rust**: Cargo projects, CLI tools, web servers
|
||||
- **Go**: Modules, Docker, microservices
|
||||
- **Java**: Maven, Gradle, Spring Boot
|
||||
- **+147 more formats**
|
||||
|
||||
## Universal Compatibility
|
||||
|
||||
### Works With Every AI Tool
|
||||
- ✅ **Claude Code** - Reads .faf natively
|
||||
- ✅ **Cursor** - Auto-syncs to .cursorrules
|
||||
- ✅ **Gemini CLI** - Converts to GEMINI.md
|
||||
- ✅ **Windsurf** - Syncs to .windsurfrules
|
||||
- ✅ **ChatGPT** - Readable YAML format
|
||||
- ✅ **Any AI** - Universal format support
|
||||
|
||||
### Migration Support
|
||||
Already have AI context files?
|
||||
```bash
|
||||
# Migrates existing context
|
||||
faf migrate --from .cursorrules
|
||||
faf migrate --from CLAUDE.md
|
||||
faf migrate --from README.md
|
||||
|
||||
# One format, works everywhere
|
||||
faf sync --target all
|
||||
```
|
||||
|
||||
## Installation Options
|
||||
|
||||
### Option 1: CLI (Recommended)
|
||||
```bash
|
||||
npm install -g faf-cli
|
||||
cd your-project
|
||||
faf auto
|
||||
```
|
||||
|
||||
### Option 2: MCP Server (Claude Code)
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"faf": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "claude-faf-mcp@latest"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Option 3: Browser Extension
|
||||
Install from Chrome Web Store - works on any Git repository.
|
||||
|
||||
## Three-Phase Intelligence
|
||||
|
||||
### Phase 1: Stack Detection
|
||||
- Scans `package.json`, `Cargo.toml`, `pyproject.toml`, etc.
|
||||
- Analyzes directory structure and file patterns
|
||||
- Identifies frameworks, deployment targets, testing setup
|
||||
|
||||
### Phase 2: Context Mining
|
||||
- Extracts project description from README
|
||||
- Identifies architecture patterns from code structure
|
||||
- Pulls dependency information for AI context
|
||||
|
||||
### Phase 3: Optimization
|
||||
- Generates focused 33-slot IANA format
|
||||
- Validates against format specification
|
||||
- Scores AI-readiness with improvement suggestions
|
||||
|
||||
## Success Metrics by Project Type
|
||||
|
||||
| Project Type | Avg Score | Time to Bronze | Detection Rate |
|
||||
|-------------|-----------|----------------|----------------|
|
||||
| **React/Vue** | 89% | Instant | 99.8% |
|
||||
| **Python Django** | 91% | Instant | 99.5% |
|
||||
| **Rust CLI** | 85% | Instant | 99.1% |
|
||||
| **Legacy PHP** | 76% | 30 seconds | 94.2% |
|
||||
| **Monorepo** | 82% | 45 seconds | 91.8% |
|
||||
|
||||
## When to Use faf-expert Instead
|
||||
|
||||
Use `faf-wizard` for:
|
||||
- ✅ Quick project onboarding
|
||||
- ✅ Automatic everything
|
||||
- ✅ "Just make it work"
|
||||
- ✅ Time-constrained scenarios
|
||||
|
||||
Use `faf-expert` for:
|
||||
- 🎯 Fine-tuned championship scoring (95%+)
|
||||
- 🎯 Complex MCP server configuration
|
||||
- 🎯 Multi-platform sync management
|
||||
- 🎯 Enterprise deployment patterns
|
||||
|
||||
## Validation & Security
|
||||
|
||||
**Enterprise-Grade Standards:**
|
||||
- ✅ **800+ comprehensive tests** across CLI and MCP
|
||||
- ✅ **No credentials ever stored** in .faf files
|
||||
- ✅ **YAML format validation** prevents malformed files
|
||||
- ✅ **IANA-registered format** (application/vnd.faf+yaml)
|
||||
- ✅ **MIT licensed** - safe for commercial use
|
||||
|
||||
## Getting Started
|
||||
|
||||
### For Your Current Project
|
||||
```bash
|
||||
# One command, done forever
|
||||
npx faf-cli auto
|
||||
|
||||
# Check the results
|
||||
cat project.faf
|
||||
```
|
||||
|
||||
### For Any GitHub Repository
|
||||
Install the browser extension and click "Generate FAF" on any repo.
|
||||
|
||||
### For Teams
|
||||
```bash
|
||||
# Set up team-wide MCP server
|
||||
faf mcp install --team
|
||||
faf sync --target all --watch
|
||||
```
|
||||
|
||||
## Community & Support
|
||||
|
||||
- **Website**: https://faf.one
|
||||
- **Chrome Extension**: 4.8★ rating, Google approved
|
||||
- **Downloads**: 52k+ across ecosystem
|
||||
- **Discord**: Active community of 1000+ developers
|
||||
- **Documentation**: Comprehensive guides and examples
|
||||
|
||||
---
|
||||
|
||||
*Stop explaining your project every session. FAF Wizard - because AI should understand your project as well as you do.*
|
||||
@@ -11755,6 +11755,50 @@
|
||||
"reasons": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "faf-expert",
|
||||
"path": "skills/faf-expert",
|
||||
"category": "coding",
|
||||
"name": "faf-expert",
|
||||
"description": "Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-04-07",
|
||||
"plugin": {
|
||||
"targets": {
|
||||
"codex": "supported",
|
||||
"claude": "supported"
|
||||
},
|
||||
"setup": {
|
||||
"type": "none",
|
||||
"summary": "",
|
||||
"docs": null
|
||||
},
|
||||
"reasons": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "faf-wizard",
|
||||
"path": "skills/faf-wizard",
|
||||
"category": "productivity",
|
||||
"name": "faf-wizard",
|
||||
"description": "Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-04-07",
|
||||
"plugin": {
|
||||
"targets": {
|
||||
"codex": "supported",
|
||||
"claude": "supported"
|
||||
},
|
||||
"setup": {
|
||||
"type": "none",
|
||||
"summary": "",
|
||||
"docs": null
|
||||
},
|
||||
"reasons": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "fal-audio",
|
||||
"path": "skills/fal-audio",
|
||||
|
||||
Reference in New Issue
Block a user