{"id":"0b67e986-7a49-4771-a525-926aa469885c","shortId":"gx4zcX","kind":"skill","title":"faf-expert","tagline":"Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync.","description":"# FAF Expert - Advanced AI Context Architecture\n\n**Master the IANA-registered format that makes AI understand your projects.**\n\nTransform 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.\n\n## When to Use This Skill\n\nUse FAF Expert when you need:\n\n| Scenario | What FAF Expert Provides |\n|----------|---------------------------|\n| **Complex project setup** | Expert configuration of .faf files and MCP servers |\n| **Championship scoring** | Achieve 85%+ AI-readiness scores for production projects |\n| **Multi-AI workflows** | Universal context that works across Claude, Cursor, Gemini, Windsurf |\n| **Legacy codebase revival** | Transform archaeology into AI-readable project DNA |\n| **Team collaboration** | Standardized context format for consistent AI assistance |\n| **Enterprise deployment** | Professional MCP server configuration and management |\n\n## Real-World Examples\n\n### Example 1: Legacy Enterprise Java System\n```yaml\n# Achieved: 92% Gold tier with FAF Expert\nproject:\n  name: enterprise-payment-api\n  goal: Mission-critical payment processing system\n  \nstack:\n  backend: java-spring\n  database: oracle\n  runtime: java-11\n  deployment: kubernetes\n  \nhuman_context:\n  where: AWS EKS production cluster\n  when: Legacy system from 2018, modernizing 2026\n  how: Spring Boot 2.7, Oracle 19c, Docker containerization\n```\n\n### Example 2: Modern React Dashboard\n```yaml\n# Achieved: 97% Gold tier performance\nproject:\n  name: analytics-dashboard\n  goal: Real-time analytics for SaaS platform\n  \nstack:\n  frontend: react-18\n  css_framework: tailwind\n  state: zustand\n  build: vite\n  testing: vitest\n  deployment: vercel\n```\n\n## Core Capabilities\n\n### 🏆 Championship Scoring System\n- **Gold Tier (95%+)**: Production-ready AI context\n- **Silver Tier (85%+)**: Professional development standard  \n- **Bronze Tier (70%+)**: Solid foundation for AI assistance\n\n### 🔧 MCP Server Configuration\nExpert setup of claude-faf-mcp with 33 tools:\n```json\n{\n  \"mcpServers\": {\n    \"faf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"claude-faf-mcp@latest\"]\n    }\n  }\n}\n```\n\n### 🔄 Bi-Directional Sync\nKeep context synchronized across platforms:\n- `.faf` ↔ `CLAUDE.md` \n- `.faf` ↔ `.cursorrules`\n- `.faf` ↔ `GEMINI.md`\n- `.faf` ↔ `AGENTS.md`\n\n### 📊 Mk4 Architecture Framework\n33-slot IANA format for comprehensive project context:\n- Project identity and goals\n- Technical stack detection  \n- Human context (who/what/why/where/when/how)\n- Architecture patterns\n- Deployment configuration\n\n## Getting Started\n\n### Quick Installation\n```bash\n# Install FAF CLI\nnpm install -g faf-cli\n\n# Initialize your project\nfaf init\n\n# Score AI-readiness\nfaf score --details\n\n# Set up MCP server\nfaf mcp install\n```\n\n### Expert Commands\n```bash\n# Advanced scoring with breakdown\nfaf score --championship --verbose\n\n# Multi-platform sync\nfaf bi-sync --target all\n\n# Validate format compliance\nfaf validate --strict\n\n# Enhanced AI optimization\nfaf enhance --model claude --focus completeness\n```\n\n## Success Metrics\n\n**Real Performance Data:**\n- **52k+ downloads** across FAF ecosystem\n- **800+ comprehensive tests** (CLI + MCP)\n- **IANA-registered format** (application/vnd.faf+yaml)\n- **153+ validated formats** supported\n- **Championship-grade performance** (<50ms execution)\n\n## Platform Compatibility\n\n### Supported AI Tools\n- ✅ **Claude Code** - Native MCP integration\n- ✅ **Cursor** - .cursorrules sync\n- ✅ **Gemini CLI** - GEMINI.md sync  \n- ✅ **Windsurf** - .windsurfrules support\n- ✅ **Universal** - Works with any AI that reads YAML\n\n### MCP Servers Available\n- `claude-faf-mcp` - 33 tools, 391 tests\n- `grok-faf-mcp` - xAI/Grok optimized\n- `rust-faf-mcp` - Native performance (4.3MB binary)\n- `gemini-faf-mcp` - Google Gemini integration\n\n## Advanced Patterns\n\n### Enterprise Configuration\n```yaml\nfaf_version: \"3.0\"\nproject:\n  name: enterprise-platform\n  tier: production\n  \nhuman_context:\n  team_size: 50+\n  compliance: SOC2, HIPAA\n  deployment: multi-region\n  \nstack:\n  architecture: microservices\n  orchestration: kubernetes\n  monitoring: datadog\n  security: vault\n```\n\n### Legacy System Revival\n```yaml\n# Transform 10-year-old codebase to AI-ready\nproject:\n  archaeology: true\n  modernization_target: 2026\n  \nstack:\n  legacy: php-5.6\n  migration_path: laravel-11\n  database_upgrade: mysql-8\n```\n\n## Expert Resources\n\n- **Documentation**: https://faf.one\n- **MCP Registry**: Official Anthropic steward\n- **CLI Reference**: `faf --help`\n- **Community**: Discord server with 1000+ developers\n- **Enterprise**: Professional support available\n\n## When to Use faf-wizard Instead\n\nUse `faf-wizard` for:\n- ✅ Quick project setup\n- ✅ One-click generation\n- ✅ Beginner-friendly workflow\n- ✅ Automated stack detection\n\nUse `faf-expert` for:\n- 🎯 Fine-tuned configuration\n- 🎯 Championship scoring optimization\n- 🎯 Multi-platform sync management\n- 🎯 Enterprise deployment patterns\n- 🎯 Advanced MCP server setup\n\n---\n\n*Master the format that makes AI understand your projects. FAF Expert - for when you need championship-grade AI context architecture.*\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","expert","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-faf-expert","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-expert","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 (5,519 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.826Z","embedding":null,"createdAt":"2026-04-18T21:36:56.624Z","updatedAt":"2026-04-24T00:50:54.826Z","lastSeenAt":"2026-04-24T00:50:54.826Z","tsv":"'-11':196,578 '-18':248 '-5.6':574 '-8':582 '1':161 '10':556 '1000':600 '153':444 '19c':218 '2':222 '2.7':216 '2018':210 '2026':212,570 '3.0':522 '33':298,332,489 '391':491 '4.3':505 '50':534 '50ms':452 '52k':428 '70':281 '800':433 '85':107,275 '92':168 '95':267 '97':228 'achiev':106,167,227 'across':57,123,319,430 'advanc':4,27,390,515,652 'agents.md':328 'ai':8,28,39,49,61,74,109,117,135,146,271,285,375,415,457,478,563,661,674 'ai-context':7 'ai-intellig':48 'ai-read':134 'ai-readi':108,374,562 'analyt':235,241 'analytics-dashboard':234 'anthrop':590 'api':179 'application/vnd.faf':442 'archaeolog':132,566 'architectur':30,330,350,543,676 'arg':305 'ask':710 'assist':147,286 'autom':629 'avail':484,605 'aw':202 'backend':188 'bash':358,389 'beginn':626 'beginner-friend':625 'bi':22,313,404 'bi-direct':21,312 'bi-sync':403 'binari':507 'boot':215 'boundari':718 'breakdown':393 'bronz':279 'build':254 'capabl':261 'championship':19,104,262,396,449,641,672 'championship-grad':448,671 'clarif':712 'claud':124,294,308,420,459,486 'claude-faf-mcp':293,307,485 'claude.md':322 'clear':685 'cli':361,367,436,468,592 'click':623 'cluster':205 'code':460 'codebas':45,129,560 'collabor':140 'command':303,388 'communiti':596 'compat':455 'complet':422 'complex':93 'complianc':410,535 'comprehens':337,434 'config':18 'configur':97,153,289,353,518,640 'consist':145 'container':220 'context':9,29,54,120,142,200,272,317,339,348,531,675 'control':66 'core':260 'criteria':721 'critic':183 'css':249 'cursor':125,464 'cursorrul':324,465 'dashboard':225,236 'data':427 'databas':192,579 'datadog':548 'deploy':149,197,258,352,538,650 'describ':689 'detail':379 'detect':346,631 'develop':75,277,601 'direct':23,314 'discord':597 'dna':138 'docker':219 'document':585 'download':429 'ecosystem':432 'ek':203 'enhanc':414,418 'enterpris':148,163,177,517,526,602,649 'enterprise-payment-api':176 'enterprise-platform':525 'environ':701 'environment-specif':700 'exampl':159,160,221 'execut':453 'expert':3,26,64,84,91,96,173,290,387,583,635,666,706 'expert-level':63 'faf':2,5,25,83,90,99,172,295,302,309,321,323,325,327,360,366,371,377,384,394,402,411,417,431,487,495,501,510,520,594,610,615,634,665 'faf-c':365 'faf-expert':1,633 'faf-wizard':609,614 'faf.one':586 'file':100 'fine':638 'fine-tun':637 'focus':421 'format':10,15,36,143,335,409,441,446,658 'foundat':6,69,283 'framework':250,331 'friend':627 'frontend':246 'g':364 'gemini':126,467,509,513 'gemini-faf-mcp':508 'gemini.md':326,469 'generat':624 'get':354 'goal':180,237,343 'gold':169,229,265 'googl':512 'grade':450,673 'grok':494 'grok-faf-mcp':493 'help':595 'hipaa':537 'human':199,347,530 'iana':13,34,334,439 'iana-regist':12,33,438 'ident':341 'init':372 'initi':368 'input':715 'instal':357,359,363,386 'instead':612 'integr':463,514 'intellig':50 'java':164,190,195 'java-spr':189 'json':300 'keep':316 'kubernet':198,546 'laravel':577 'latest':311 'layer':70 'legaci':128,162,207,551,572 'level':65 'limit':677 'make':38,660 'manag':155,648 'master':31,656 'match':686 'mb':506 'mcp':16,102,151,287,296,310,382,385,437,462,482,488,496,502,511,587,653 'mcpserver':301 'metric':424 'microservic':544 'migrat':575 'miss':723 'mission':182 'mission-crit':181 'mk4':329 'model':419 'modern':73,211,223,568 'monitor':547 'multi':116,399,540,645 'multi-ai':115 'multi-platform':398,644 'multi-region':539 'mysql':581 'name':175,233,524 'nativ':461,503 'need':87,670 'npm':362 'npx':304 'offici':589 'old':559 'one':622 'one-click':621 'optim':416,498,643 'oracl':193,217 'orchestr':545 'output':695 'path':576 'pattern':351,516,651 'payment':178,184 'perform':231,426,451,504 'permiss':716 'persist':53 'php':573 'platform':62,244,320,400,454,527,646 'power':72 'process':185 'product':113,204,269,529 'production-readi':268 'profession':150,276,603 'project':42,51,94,114,137,174,232,338,340,370,523,565,619,664 'provid':92 'quick':356,618 'react':224,247 'read':480 'readabl':136 'readi':110,270,376,564 'real':157,239,425 'real-tim':238 'real-world':156 'refer':593 'region':541 'regist':14,35,440 'registri':588 'requir':714 'resourc':584 'review':707 'reviv':130,553 'runtim':194 'rust':500 'rust-faf-mcp':499 'saa':243 'safeti':717 'scenario':88 'scope':688 'score':20,105,111,263,373,378,391,395,642 'secur':549 'server':17,103,152,288,383,483,598,654 'session':58 'set':380 'setup':95,291,620,655 'silver':273 'size':533 'skill':81,680 'skill-faf-expert' 'slot':333 'soc2':536 'solid':282 'source-sickn33' 'specialist':11 'specif':702 'spring':191,214 'stack':187,245,345,542,571,630 'standard':141,278 'start':355 'state':252 'steward':591 'stop':708 'strict':413 'substitut':698 'success':423,720 'support':447,456,473,604 'surviv':56 'sync':24,315,401,405,466,470,647 'synchron':318 'system':165,186,208,264,552 'tailwind':251 'target':406,569 'task':684 'team':139,532 'technic':344 'test':256,435,492,704 'tier':170,230,266,274,280,528 'time':240 'tool':59,299,458,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':43,131,555 'treat':693 'true':567 'tune':639 'understand':40,662 'univers':119,474 'upgrad':580 'use':79,82,608,613,632,678 'valid':408,412,445,703 'vault':550 'verbos':397 'vercel':259 'version':521 'vite':255 'vitest':257 'who/what/why/where/when/how':349 'windsurf':127,471 'windsurfrul':472 'wizard':611,616 'work':122,475 'workflow':76,118,628 'world':158 'xai/grok':497 'y':306 'yaml':166,226,443,481,519,554 'year':558 'year-old':557 'zustand':253","prices":[{"id":"01b5f416-91d3-4513-a883-35358efadfcd","listingId":"0b67e986-7a49-4771-a525-926aa469885c","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:56.624Z"}],"sources":[{"listingId":"0b67e986-7a49-4771-a525-926aa469885c","source":"github","sourceId":"sickn33/antigravity-awesome-skills/faf-expert","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/faf-expert","isPrimary":false,"firstSeenAt":"2026-04-18T21:36:56.624Z","lastSeenAt":"2026-04-24T00:50:54.826Z"}],"details":{"listingId":"0b67e986-7a49-4771-a525-926aa469885c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"faf-expert","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":"65d6c0f66e6a11e303615f0a07d320f0b9de98d5","skill_md_path":"skills/faf-expert/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/faf-expert"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"faf-expert","description":"Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/faf-expert"},"updatedAt":"2026-04-24T00:50:54.826Z"}}