diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 3f793ca2..b42e8fa9 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -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" diff --git a/CATALOG.md b/CATALOG.md index cdcff1a5..33f52de2 100644 --- a/CATALOG.md +++ b/CATALOG.md @@ -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 | diff --git a/README.md b/README.md index 5fedd924..9bd8c53e 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,13 @@ - -# ๐ŸŒŒ Antigravity Awesome Skills: 1,379+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More + +# ๐ŸŒŒ 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) [![GitHub stars](https://img.shields.io/badge/โญ%2031%2C000%2B%20Stars-gold?style=for-the-badge)](https://github.com/sickn33/antigravity-awesome-skills/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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. diff --git a/apps/web-app/public/sitemap.xml b/apps/web-app/public/sitemap.xml index be0155c8..ed7d0a7a 100644 --- a/apps/web-app/public/sitemap.xml +++ b/apps/web-app/public/sitemap.xml @@ -12,6 +12,18 @@ weekly 0.7 + + http://localhost/skill/faf-expert + 2026-04-07 + weekly + 0.7 + + + http://localhost/skill/faf-wizard + 2026-04-07 + weekly + 0.7 + http://localhost/skill/idea-darwin 2026-04-07 @@ -234,16 +246,4 @@ weekly 0.7 - - http://localhost/skill/viboscope - 2026-04-07 - weekly - 0.7 - - - http://localhost/skill/jq - 2026-04-07 - weekly - 0.7 - diff --git a/apps/web-app/public/skills.json.backup b/apps/web-app/public/skills.json.backup index 055275a9..4352f4f5 100644 --- a/apps/web-app/public/skills.json.backup +++ b/apps/web-app/public/skills.json.backup @@ -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", diff --git a/data/bundles.json b/data/bundles.json index c0c3346d..4893e18a 100644 --- a/data/bundles.json +++ b/data/bundles.json @@ -816,6 +816,7 @@ "e2e-testing", "email-sequence", "expo-cicd-workflows", + "faf-wizard", "fal-workflow", "figma-automation", "freshdesk-automation", diff --git a/data/catalog.json b/data/catalog.json index ec0d9778..647723a5 100644 --- a/data/catalog.json +++ b/data/catalog.json @@ -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", diff --git a/data/plugin-compatibility.json b/data/plugin-compatibility.json index 266cc1a1..17bf249b 100644 --- a/data/plugin-compatibility.json +++ b/data/plugin-compatibility.json @@ -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, diff --git a/docs/integrations/jetski-cortex.md b/docs/integrations/jetski-cortex.md index 90986782..2aa1937f 100644 --- a/docs/integrations/jetski-cortex.md +++ b/docs/integrations/jetski-cortex.md @@ -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. --- diff --git a/docs/integrations/jetski-gemini-loader/README.md b/docs/integrations/jetski-gemini-loader/README.md index 2f8f4745..00fc896b 100644 --- a/docs/integrations/jetski-gemini-loader/README.md +++ b/docs/integrations/jetski-gemini-loader/README.md @@ -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. --- diff --git a/docs/maintainers/repo-growth-seo.md b/docs/maintainers/repo-growth-seo.md index 63f201bb..eb296f7b 100644 --- a/docs/maintainers/repo-growth-seo.md +++ b/docs/maintainers/repo-growth-seo.md @@ -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. diff --git a/docs/maintainers/skills-update-guide.md b/docs/maintainers/skills-update-guide.md index 0308096a..553a203a 100644 --- a/docs/maintainers/skills-update-guide.md +++ b/docs/maintainers/skills-update-guide.md @@ -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 diff --git a/docs/users/bundles.md b/docs/users/bundles.md index 9ee1a6ba..f3975d58 100644 --- a/docs/users/bundles.md +++ b/docs/users/bundles.md @@ -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_ diff --git a/docs/users/claude-code-skills.md b/docs/users/claude-code-skills.md index 78fb244b..da5e7248 100644 --- a/docs/users/claude-code-skills.md +++ b/docs/users/claude-code-skills.md @@ -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. diff --git a/docs/users/gemini-cli-skills.md b/docs/users/gemini-cli-skills.md index 88994530..6e3dfb12 100644 --- a/docs/users/gemini-cli-skills.md +++ b/docs/users/gemini-cli-skills.md @@ -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 diff --git a/docs/users/kiro-integration.md b/docs/users/kiro-integration.md index d4a0c3f8..585c782c 100644 --- a/docs/users/kiro-integration.md +++ b/docs/users/kiro-integration.md @@ -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 diff --git a/docs/users/usage.md b/docs/users/usage.md index 02f413ca..8f59d845 100644 --- a/docs/users/usage.md +++ b/docs/users/usage.md @@ -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: diff --git a/docs/users/visual-guide.md b/docs/users/visual-guide.md index 6af7c4c1..f06fd0c5 100644 --- a/docs/users/visual-guide.md +++ b/docs/users/visual-guide.md @@ -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) โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ``` diff --git a/package.json b/package.json index 58f85085..2e97af2e 100644 --- a/package.json +++ b/package.json @@ -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", diff --git a/plugins/antigravity-awesome-skills-claude/.claude-plugin/plugin.json b/plugins/antigravity-awesome-skills-claude/.claude-plugin/plugin.json index 3f793ca2..b42e8fa9 100644 --- a/plugins/antigravity-awesome-skills-claude/.claude-plugin/plugin.json +++ b/plugins/antigravity-awesome-skills-claude/.claude-plugin/plugin.json @@ -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" diff --git a/plugins/antigravity-awesome-skills-claude/skills/faf-expert/SKILL.md b/plugins/antigravity-awesome-skills-claude/skills/faf-expert/SKILL.md new file mode 100644 index 00000000..891eb98e --- /dev/null +++ b/plugins/antigravity-awesome-skills-claude/skills/faf-expert/SKILL.md @@ -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.* \ No newline at end of file diff --git a/plugins/antigravity-awesome-skills-claude/skills/faf-wizard/SKILL.md b/plugins/antigravity-awesome-skills-claude/skills/faf-wizard/SKILL.md new file mode 100644 index 00000000..e7577d43 --- /dev/null +++ b/plugins/antigravity-awesome-skills-claude/skills/faf-wizard/SKILL.md @@ -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.* \ No newline at end of file diff --git a/plugins/antigravity-awesome-skills/.codex-plugin/plugin.json b/plugins/antigravity-awesome-skills/.codex-plugin/plugin.json index 14439d7b..3ed49ff1 100644 --- a/plugins/antigravity-awesome-skills/.codex-plugin/plugin.json +++ b/plugins/antigravity-awesome-skills/.codex-plugin/plugin.json @@ -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", diff --git a/plugins/antigravity-awesome-skills/skills/faf-expert/SKILL.md b/plugins/antigravity-awesome-skills/skills/faf-expert/SKILL.md new file mode 100644 index 00000000..891eb98e --- /dev/null +++ b/plugins/antigravity-awesome-skills/skills/faf-expert/SKILL.md @@ -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.* \ No newline at end of file diff --git a/plugins/antigravity-awesome-skills/skills/faf-wizard/SKILL.md b/plugins/antigravity-awesome-skills/skills/faf-wizard/SKILL.md new file mode 100644 index 00000000..e7577d43 --- /dev/null +++ b/plugins/antigravity-awesome-skills/skills/faf-wizard/SKILL.md @@ -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.* \ No newline at end of file diff --git a/skills_index.json b/skills_index.json index 055275a9..4352f4f5 100644 --- a/skills_index.json +++ b/skills_index.json @@ -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",