From faf
Expert in .faf (Foundational AI-context Format) files for persistent project context. Use when working with .faf files, project DNA, CLAUDE.md bi-sync, faf-cli commands, MCP server configuration, or AI-readiness scoring (0-100%). Updated for v5.2.0.
How this skill is triggered — by the user, by Claude, or both
Slash command
/faf:faf-expertThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **Become an expert.** The mechanic's manual — install, configure, troubleshoot, score.
Become an expert. The mechanic's manual — install, configure, troubleshoot, score. See also:
faf-wizard— the "done for you" pit crew that generates .faf files for any project.
The package.json for Context.
project/
├── package.json ← npm reads this
├── project.faf ← AI reads this
├── README.md
└── src/
"package.json wasn't built for this, .faf was" — .faf Inventor
"package.json gives me a list of dependencies, .faf shows me how to use them" — Claude Code (Anthropic)
Once you get used to it, it's just another file helping you code.
.faf is the universal format for persistent AI project context - "Project DNA ✨ for ANY AI".
Core Concepts:
Activate this skill when:
.faf filesCLAUDE.md filesfaf CLI commands (init, auto, score, formats, bi-sync).faf - YAML format, machine-readable project contextCLAUDE.md - Markdown format, human-readable project guide.faf ↔ CLAUDE.md kept in sync automaticallyproject.faf - v1.2.0 standard namingfaf init # Create .faf from project
faf auto # Auto-detect stack and create .faf
faf score # Rate AI-readiness (0-100%)
faf formats # List 153+ supported formats
faf bi-sync # Sync .faf ↔ CLAUDE.md
faf status # Check project AI-readiness
faf validate # Validate .faf structure
faf doctor # Diagnose and fix issues
faf migrate # Migrate to latest format
33 tools available:
Configuration:
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@latest"],
"env": {
"FAF_MCP_SHOW_ADVANCED": "false"
}
}
}
}
Core Tools (21):
faf, faf_auto, faf_init, faf_innit, faf_statusfaf_score, faf_validate, faf_doctor, faf_auditfaf_formats, faf_stacks, faf_skills, faf_install_skillfaf_sync, faf_bi_sync, faf_update, faf_migratefaf_chat, faf_enhancefaf_index, faf_faq, faf_aboutAdvanced Tools (30+):
Set FAF_MCP_SHOW_ADVANCED: "true" to enable:
faf_display, faf_show, faf_checkfaf_trust, faf_trust_confidence, faf_trust_garagefaf_read, faf_write, faf_list, faf_exists, etc.faf_dna, faf_log, faf_auth, faf_recoverfaf_choose, faf_clear, faf_share, faf_creditChampionship Tiers:
Target: 85%+ for production projects
# Basic .faf structure
format: typescript-nextjs
language: typescript
framework: nextjs
version: "14.0.0"
structure:
- src/
- components/
- pages/
dependencies:
react: "^18.0.0"
next: "^14.0.0"
testing: jest
deployment: vercel
# v1.2.0+ additions
project_name: "My Project"
ai_readiness_score: 87
faf auto - Let it detect your stackfaf score - Target 85%+ for championship contextfaf bi-sync - Keep .faf and CLAUDE.md in sync6 Championship Integrations:
npm install -g faf-cli
brew install faf-cli
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@latest"]
}
}
}
For advanced tools:
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@latest"],
"env": {
"FAF_MCP_SHOW_ADVANCED": "true"
}
}
}
}
Problem Solved: Reduced cognitive load from 51 tools to 21 core tools.
How It Works:
Categories:
workflow - Essential commandsquality - Scoring and validationintelligence - Format/stack detectionsync - Context synchronizationai - AI enhancement featureshelp - Documentationtrust - Trust validationfile - File operationsutility - Misc toolsConfiguration Priority:
FAF_MCP_SHOW_ADVANCED)~/.fafrc)The Noodle Philosophy 🍜
Format-First
Official Stewardship
brew install faf-cliWJTTC (WolfeJam Technical & Testing Center)
# Check logs
tail -f ~/Library/Logs/Claude/mcp-server-claude-faf-mcp.log
# Verify config
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Test locally
node /path/to/claude-faf-mcp/dist/src/index.js
# Should show 21 core tools (default)
# Or 51 tools (advanced mode)
# Check console output when MCP loads
# Install globally
npm install -g faf-cli
# Or via Homebrew
brew install faf-cli
# Verify installation
faf --version
Create ~/.fafrc:
{
"showAdvanced": true
}
Or key=value format:
FAF_SHOW_ADVANCED=true
# Use local build
{
"mcpServers": {
"faf": {
"command": "node",
"args": ["/path/to/claude-faf-mcp/dist/src/index.js"],
"env": {
"FAF_MCP_SHOW_ADVANCED": "false"
}
}
}
}
To disable this skill temporarily:
# Rename directory to disable
mv ~/.claude/skills/faf-expert ~/.claude/skills/faf-expert.disabled
To re-enable:
# Rename back to enable
mv ~/.claude/skills/faf-expert.disabled ~/.claude/skills/faf-expert
Or just delete the directory to remove completely.
Option 1: Manual Installation
~/.claude/skills/faf-expert/~/.claude/skills/faf-expert/SKILL.mdOption 2: Git Clone (if published)
# Coming soon - published skills repository
git clone [skills-repo] ~/.claude/skills/faf-expert
Option 3: From FAF CLI (future)
# Planned feature
faf skill install faf-expert
Made with 🧡 by wolfejam.dev Official Anthropic MCP Steward Championship Edition v5.1.0 🏎️✨ IANA-Registered Format: application/vnd.faf+yaml (Oct 30, 2025)
npx claudepluginhub wolfe-jam/faf-skillsExpert in the .faf format for persistent project context across AI tools. Scores AI-readiness, syncs context to CLAUDE.md, and manages the faf-cli toolkit. Use when working with .faf files or the FCL doctrine.
Configures IANA-registered .faf files for persistent AI project context, MCP server setup, championship scoring, and bi-directional sync across Claude, Cursor, Gemini, Windsurf.
Generates or updates AGENTS.md/CLAUDE.md files for AI coding agents by auto-scanning project files combined with interactive Q&A. Supports multiple tech stacks and preserves customizations when updating.