{"id":"3a0791e2-1eeb-479e-96ea-09f7efe89e0d","shortId":"kuQq4G","kind":"skill","title":"faf-wizard","tagline":"Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere.","description":"# FAF Wizard - One-Click AI Intelligence\n\n**The pit crew for your projects.** Point it at any codebase and get scored, AI-ready context in 60 seconds.\n\nTransform any project - new, legacy, famous OSS, or forgotten side projects - into an AI-intelligent workspace with persistent context that works across all AI tools.\n\n## The Problem It Solves\n\n**Even React.js scores 0% AI-readiness.** Famous repositories have no AI context.\n\n| What Exists | What It Tells AI |\n|-------------|------------------|\n| README.md | \"What this does\" (for humans) |\n| docs/ | \"How to use it\" (for humans) |\n| **project.faf** | \"How to help build this\" (for AI) |\n\nDocumentation tells humans how to use your code. AI context tells AI how to help you build it. **They're completely different things.**\n\n## Works on ANY Project\n\n| Project Type | What FAF Wizard Does |\n|-------------|----------------------|\n| **Brand new** | Perfect AI context from line one |\n| **Legacy nightmare** | AI finally understands the archaeology |\n| **Famous OSS** | Even React doesn't have this |\n| **Side projects** | Stop re-explaining every session |\n| **Client handoffs** | Portable context for any AI tool |\n| **Team projects** | Shared context that everyone can use |\n\n## Real Success Stories\n\n### Before/After: Legacy E-commerce Platform\n```\nBefore: \"This 50k-line PHP codebase from 2015...\"\nAI: \"I don't understand this architecture\"\n\nAfter: 60 seconds with FAF Wizard\nAI: \"I see this is a Laravel-based e-commerce system with \npayment processing, inventory management, and multi-tenant \narchitecture. Here's how I can help...\"\n```\n\n### Before/After: Modern React App\n```\nBefore: Every AI session starts with context explanation\nTime lost: 5-10 minutes per session\n\nAfter: project.faf exists\nAI: Instant understanding, productive from message one\nTime saved: 2+ hours per day\n```\n\n## The 60-Second Workflow\n\n### Step 1: Detection (10 seconds)\n```bash\nfaf auto\n# Scans manifest files, directory structure, dependencies\n# Detects: React + TypeScript + Tailwind + Vercel\n```\n\n### Step 2: Generation (30 seconds)  \n```yaml\n# Auto-generated project.faf\nproject:\n  name: my-saas-dashboard  \n  goal: Customer analytics platform\n\nstack:\n  frontend: react-18\n  css: tailwind\n  deployment: vercel\n  \nhuman_context:\n  who: Solo founder\n  what: SaaS analytics dashboard\n  why: Customer insights for small businesses\n```\n\n### Step 3: Scoring & Report (20 seconds)\n```\n✅ Generated: project.faf\n🏆 AI-Readiness: 87% Bronze - Production ready\n\nFilled: 9/11 active slots\nIgnored: 22 slots (not applicable)\n\nTo reach Silver (95%):\n  + Add API documentation (+5%)  \n  + Define deployment details (+3%)\n```\n\n## Performance Data (Real Numbers)\n\n**Analyzed 8,400+ Projects:**\n- ✅ **99.2% detection accuracy** across 153+ formats\n- ✅ **Average generation time**: 12.3 seconds\n- ✅ **Bronze tier or higher**: 94% of projects\n- ✅ **Zero manual configuration**: Works out of the box\n\n### Format Support\nAutomatically detects and configures:\n- **JavaScript**: React, Vue, Angular, Svelte, Next.js, Nuxt\n- **Python**: Django, Flask, FastAPI, Jupyter, Poetry\n- **TypeScript**: All JS frameworks + native TS projects  \n- **Rust**: Cargo projects, CLI tools, web servers\n- **Go**: Modules, Docker, microservices\n- **Java**: Maven, Gradle, Spring Boot\n- **+147 more formats**\n\n## Universal Compatibility\n\n### Works With Every AI Tool\n- ✅ **Claude Code** - Reads .faf natively\n- ✅ **Cursor** - Auto-syncs to .cursorrules  \n- ✅ **Gemini CLI** - Converts to GEMINI.md\n- ✅ **Windsurf** - Syncs to .windsurfrules\n- ✅ **ChatGPT** - Readable YAML format\n- ✅ **Any AI** - Universal format support\n\n### Migration Support\nAlready have AI context files?\n```bash\n# Migrates existing context\nfaf migrate --from .cursorrules\nfaf migrate --from CLAUDE.md  \nfaf migrate --from README.md\n\n# One format, works everywhere\nfaf sync --target all\n```\n\n## Installation Options\n\n### Option 1: CLI (Recommended)\n```bash\nnpm install -g faf-cli\ncd your-project\nfaf auto\n```\n\n### Option 2: MCP Server (Claude Code)\n```json\n{\n  \"mcpServers\": {\n    \"faf\": {\n      \"command\": \"npx\", \n      \"args\": [\"-y\", \"claude-faf-mcp@latest\"]\n    }\n  }\n}\n```\n\n### Option 3: Browser Extension\nInstall from Chrome Web Store - works on any Git repository.\n\n## Three-Phase Intelligence\n\n### Phase 1: Stack Detection\n- Scans `package.json`, `Cargo.toml`, `pyproject.toml`, etc.\n- Analyzes directory structure and file patterns\n- Identifies frameworks, deployment targets, testing setup\n\n### Phase 2: Context Mining  \n- Extracts project description from README\n- Identifies architecture patterns from code structure\n- Pulls dependency information for AI context\n\n### Phase 3: Optimization\n- Generates focused 33-slot IANA format\n- Validates against format specification\n- Scores AI-readiness with improvement suggestions\n\n## Success Metrics by Project Type\n\n| Project Type | Avg Score | Time to Bronze | Detection Rate |\n|-------------|-----------|----------------|----------------|\n| **React/Vue** | 89% | Instant | 99.8% |\n| **Python Django** | 91% | Instant | 99.5% |  \n| **Rust CLI** | 85% | Instant | 99.1% |\n| **Legacy PHP** | 76% | 30 seconds | 94.2% |\n| **Monorepo** | 82% | 45 seconds | 91.8% |\n\n## When to Use faf-expert Instead\n\nUse `faf-wizard` for:\n- ✅ Quick project onboarding\n- ✅ Automatic everything\n- ✅ \"Just make it work\"\n- ✅ Time-constrained scenarios\n\nUse `faf-expert` for:\n- 🎯 Fine-tuned championship scoring (95%+)\n- 🎯 Complex MCP server configuration\n- 🎯 Multi-platform sync management  \n- 🎯 Enterprise deployment patterns\n\n## Validation & Security\n\n**Enterprise-Grade Standards:**\n- ✅ **800+ comprehensive tests** across CLI and MCP\n- ✅ **No credentials ever stored** in .faf files\n- ✅ **YAML format validation** prevents malformed files\n- ✅ **IANA-registered format** (application/vnd.faf+yaml)\n- ✅ **MIT licensed** - safe for commercial use\n\n## Getting Started\n\n### For Your Current Project\n```bash\n# One command, done forever\nnpx faf-cli auto\n\n# Check the results\ncat project.faf\n```\n\n### For Any GitHub Repository  \nInstall the browser extension and click \"Generate FAF\" on any repo.\n\n### For Teams\n```bash\n# Set up team-wide MCP server\nfaf mcp install --team\nfaf sync --target all --watch\n```\n\n## Community & Support\n\n- **Website**: https://faf.one\n- **Chrome Extension**: 4.8★ rating, Google approved\n- **Downloads**: 52k+ across ecosystem  \n- **Discord**: Active community of 1000+ developers\n- **Documentation**: Comprehensive guides and examples\n\n---\n\n*Stop explaining your project every session. FAF Wizard - because AI should understand your project as well as you do.*\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["faf","wizard","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-faf-wizard","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/faf-wizard","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34793 github stars · SKILL.md body (6,908 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T00:50:54.907Z","embedding":null,"createdAt":"2026-04-18T21:36:57.388Z","updatedAt":"2026-04-24T00:50:54.907Z","lastSeenAt":"2026-04-24T00:50:54.907Z","tsv":"'+147':481 '+3':404 '+5':400 '-10':283 '-18':349 '0':91 '1':308,554,607 '10':310 '1000':866 '12.3':422 '153':417 '2':299,327,571,628 '20':373 '2015':225 '22':389 '3':370,589,649 '30':329,699 '33':653 '4.8':854 '400':411 '45':704 '5':282 '50k':220 '50k-line':219 '52k':859 '60':56,234,304 '76':698 '8':410 '800':761 '82':703 '85':693 '87':380 '89':683 '9/11':385 '91':688 '91.8':706 '94':428 '94.2':701 '95':396,742 '99.1':695 '99.2':413 '99.5':690 '99.8':685 'accuraci':415 'across':80,416,764,860 'activ':386,863 'add':397 'ai':13,35,52,72,82,93,99,106,127,136,139,164,171,198,226,239,274,290,378,489,516,524,646,663,882 'ai-intellig':71 'ai-readi':51,92,377,662 'alreadi':522 'analyt':344,361 'analyz':409,615 'angular':448 'api':398 'app':271 'applic':392 'application/vnd.faf':785 'approv':857 'archaeolog':175 'architectur':232,261,637 'arg':581 'ask':925 'auto':23,314,333,498,569,808 'auto-detect':22 'auto-gener':332 'auto-sync':497 'automat':441,722 'averag':419 'avg':675 'base':247 'bash':312,527,557,799,831 'before/after':211,268 'boot':480 'boundari':933 'box':438 'brand':161 'bronz':381,424,679 'browser':590,820 'build':124,144 'busi':368 'cargo':466 'cargo.toml':612 'cat':812 'cd':564 'championship':740 'chatgpt':511 'check':809 'chrome':594,852 'clarif':927 'claud':491,574,584 'claude-faf-mcp':583 'claude.md':538 'clear':900 'cli':468,503,555,563,692,765,807 'click':12,34,823 'client':192 'code':135,492,575,640 'codebas':47,223 'command':579,801 'commerc':215,250 'commerci':791 'communiti':848,864 'compat':485 'complet':148 'complex':743 'comprehens':762,869 'configur':433,444,746 'constrain':730 'context':14,54,77,100,137,165,195,203,278,355,525,530,629,647 'convert':504 'credenti':769 'crew':39 'criteria':936 'css':350 'current':797 'cursor':496 'cursorrul':501,534 'custom':343,364 'dashboard':341,362 'data':406 'day':302 'defin':401 'depend':320,643 'deploy':352,402,623,753 'describ':904 'descript':633 'detail':403 'detect':24,309,321,414,442,609,680 'develop':867 'differ':149 'directori':318,616 'discord':862 'django':453,687 'doc':113 'docker':474 'document':128,399,868 'doesn':180 'done':5,802 'done-for-you':4 'download':858 'e':214,249 'e-commerc':213,248 'ecosystem':861 'enterpris':752,758 'enterprise-grad':757 'environ':916 'environment-specif':915 'etc':614 'even':88,178 'ever':770 'everi':190,273,488,877 'everyon':205 'everyth':723 'everywher':29,546 'exampl':872 'exist':102,289,529 'expert':712,735,921 'explain':189,874 'explan':279 'extens':591,821,853 'extract':631 'faf':2,8,30,158,237,313,494,531,535,539,547,562,568,578,585,711,716,734,773,806,825,839,843,879 'faf-c':561,805 'faf-expert':710,733 'faf-wizard':1,715 'faf.one':851 'famous':21,63,95,176 'fastapi':455 'file':317,526,619,774,780 'fill':384 'final':172 'fine':738 'fine-tun':737 'flask':454 'focus':652 'forev':803 'forgotten':66 'format':418,439,483,514,518,544,656,659,776,784 'founder':358 'framework':461,622 'frontend':347 'g':560 'gemini':502 'gemini.md':506 'generat':9,328,334,375,420,651,824 'get':49,793 'git':600 'github':816 'go':472 'goal':342 'googl':856 'grade':759 'gradl':478 'guid':870 'handoff':193 'help':123,142,267 'higher':427 'hour':300 'human':112,119,130,354 'iana':655,782 'iana-regist':781 'identifi':621,636 'ignor':388 'improv':666 'inform':644 'input':930 'insight':365 'instal':551,559,592,818,841 'instant':291,684,689,694 'instead':713 'intellig':36,73,605 'inventori':255 'java':476 'javascript':445 'js':460 'json':576 'jupyt':456 'laravel':246 'laravel-bas':245 'latest':587 'legaci':19,62,169,212,696 'licens':788 'limit':892 'line':167,221 'lost':281 'make':725 'malform':779 'manag':256,751 'manifest':316 'manual':432 'match':901 'maven':477 'mcp':572,586,744,767,837,840 'mcpserver':577 'messag':295 'metric':669 'microservic':475 'migrat':520,528,532,536,540 'mine':630 'minut':284 'miss':938 'mit':787 'modern':269 'modul':473 'monorepo':702 'multi':259,748 'multi-platform':747 'multi-ten':258 'my-saas-dashboard':338 'name':337 'nativ':462,495 'new':18,61,162 'next.js':450 'nightmar':170 'npm':558 'npx':580,804 'number':408 'nuxt':451 'onboard':721 'one':11,33,168,296,543,800 'one-click':10,32 'optim':650 'option':552,553,570,588 'oss':64,177 'output':910 'package.json':611 'pattern':620,638,754 'payment':253 'per':285,301 'perfect':163 'perform':405 'permiss':931 'persist':76 'phase':604,606,627,648 'php':222,697 'pit':38 'platform':216,345,749 'poetri':457 'point':43 'portabl':194 'prevent':778 'problem':85 'process':254 'product':293,382 'project':17,42,60,68,154,155,185,201,336,412,430,464,467,567,632,671,673,720,798,876,886 'project.faf':120,288,335,376,813 'pull':642 'pyproject.toml':613 'python':452,686 'quick':719 'rate':681,855 're':147,188 're-explain':187 'reach':394 'react':179,270,322,348,446 'react.js':89 'react/vue':682 'read':493 'readabl':512 'readi':27,53,94,379,383,664 'readm':635 'readme.md':107,542 'real':208,407 'recommend':556 'regist':783 'repo':828 'report':372 'repositori':96,601,817 'requir':929 'result':811 'review':922 'rust':465,691 'saa':340,360 'safe':789 'safeti':932 'save':298 'scan':315,610 'scenario':731 'scope':903 'score':26,50,90,371,661,676,741 'second':57,235,305,311,330,374,423,700,705 'secur':756 'see':241 'server':471,573,745,838 'session':191,275,286,878 'set':832 'setup':626 'share':202 'side':67,184 'silver':395 'skill':895 'skill-faf-wizard' 'slot':387,390,654 'small':367 'solo':357 'solv':87 'source-sickn33' 'specif':660,917 'spring':479 'stack':25,346,608 'standard':760 'start':276,794 'step':307,326,369 'stop':186,873,923 'store':596,771 'stori':210 'structur':319,617,641 'substitut':913 'success':209,668,935 'suggest':667 'support':440,519,521,849 'svelt':449 'sync':499,508,548,750,844 'system':251 'tailwind':324,351 'target':549,624,845 'task':899 'team':200,830,835,842 'team-wid':834 'tell':105,129,138 'tenant':260 'test':625,763,919 'thing':150 'three':603 'three-phas':602 'tier':425 'time':280,297,421,677,729 'time-constrain':728 'tool':83,199,469,490 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'transform':58 'treat':908 'ts':463 'tune':739 'type':156,672,674 'typescript':323,458 'understand':173,230,292,884 'univers':484,517 'use':116,133,207,709,714,732,792,893 'valid':657,755,777,918 'vercel':325,353 'vue':447 'watch':847 'web':470,595 'websit':850 'well':888 'wide':836 'windsurf':507 'windsurfrul':510 'wizard':3,31,159,238,717,880 'work':28,79,151,434,486,545,597,727 'workflow':306 'workspac':74 'y':582 'yaml':331,513,775,786 'your-project':565 'zero':431","prices":[{"id":"92a96bf9-9a48-47bb-9d9d-db38b6586b4e","listingId":"3a0791e2-1eeb-479e-96ea-09f7efe89e0d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:36:57.388Z"}],"sources":[{"listingId":"3a0791e2-1eeb-479e-96ea-09f7efe89e0d","source":"github","sourceId":"sickn33/antigravity-awesome-skills/faf-wizard","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/faf-wizard","isPrimary":false,"firstSeenAt":"2026-04-18T21:36:57.388Z","lastSeenAt":"2026-04-24T00:50:54.907Z"}],"details":{"listingId":"3a0791e2-1eeb-479e-96ea-09f7efe89e0d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"faf-wizard","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34793,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T00:28:59Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"f679b48026ac69ac27356c3e835e9fce6dd5e94b","skill_md_path":"skills/faf-wizard/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/faf-wizard"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"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."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/faf-wizard"},"updatedAt":"2026-04-24T00:50:54.907Z"}}